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The design, develooment and i to! ementat i on of a user- 
oriented graohics software system is described. The over-all 
considerations involved in such a design orocess are dis- 
cussed/ along with the major factors affecting design deci- 
sions. The object disclay system is a R A M T E K GX-10 0A hosted 
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I 



INTRODUCTION 



Design techniques for user-oriented graohi cs software 
systems are invest iceteo. The orincicles and techniques 
gained from this research have D e e n aoolied in the implemen- 
tation of such a system for a PA r1 TEK G X - 1 0 0 A ai sol ay device. 

Primary emphasis is ol aced on oroviding a user with the 
prooerly constructed software support and accompanying docu- 
mentation for efficient utilization of the grachics display 
system. The techniques and decisions involved in performing 
such a design are discussed in detail. 

Additionally, the Vector General Tablet was interfaced 
with the supocrt system. This interface provided the user 
with an external interactive device for control of the 
graphics system. The ability to interact with the system 
greatly enhanced the desirability of the over-all design. 

The basic steps in the application pnase * e r e to choose 
a lanauace, desicn systems functions, write a detailed 
user’s manual, and implement ana test the system. The user’s 
manual ( 4 p o e n a i * A) provides even the inexperienced program- 
mer with a tool for rapid access to the system. It is com- 
plemented with a tutorial s e f of examples that more accom- 
plished users m i a h t proceed to immediately. 
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The desianea system was imolemented in the C orcgram- 



m i n g language and hosted by a POP-1 1/50 comcuter in the 
Naval Postgraduate School Computer Lacoratory . 



/ 



DESIGN CONSIDERATIONS 



II . 



The following is a quote from Dr. Eric Carlson of the 
IB M Research Division ( 1^11 : 

"In the oast/ progress in terminal hardware technol oay 
and craohics software techniques has not been accom- 
panied by similar oroaress in unaerstanainq the 
requirements of the user and applications of computer 
graphics”. 

The desian effort/ therefore/ in comouter Graphics must be 
apolied to provide clarity in man/machine communication. 

The evolutionary process of a user-oriented svstem must 
begin wit h a firm definition of the user. In this context a 



user is defined 


to be some 


person or group 


o f 


Persons 


who 


desire to util 


i ze some 


graphics system. 


be / 


for the 


nos t 



part/ is a non-comouter scientist who s i m n 1 y wishes to be 
assisted Cy the computer in the solution of some problem. If 
he must expend a great deal of effort to learn how to use 
the system oefore any benefits can be accrued/ then the sys- 
tem appears not to ne a tool out just, another hurdle. 

Any computer system has the ultimate curoose of solving 
a problem or set of problems, in hen a user elects to utilize 
the oower of a computer system to solve a problem/ then un<- 
nowinqly he or she has added tne requirement that the orod- 



lem be stated in two very distinct ways. The problem must on 



one hand take on a structure that is amenable to the com- 
puter/ and on the other hand be statec clearly and concisely 
to man. As the user’s statement of the problem is decomposed 
to a machine-oriented statement of the same problem, the 
interface between the user and the system is critical. The 
ideal interface provides a ccnservat ional communication or 
" symbiosis'* between man and machine. 

The user m U st ce nrovioea as many aids as ohysically 
possible to create an atmosohere that is conducive to 
creative thought. If he expends the majority of his effort 
attempting to communicate, he is not likely to be very 
creative* Thus the man-machine communication must be 
enhanced in every conceivable manner. 

The design effort must, necessarily, begin with con- 
siderations of available ecuioment. If the eauioment is 
alreaav in Position, as it was in this endeavor, the 
designer should strive to interface aooroor iate interactive 
tools for a oleasant communication scheme. These devices, 
though Quite varied, "can be treated as a physical realiza- 
tion of one of four virtual devices : the oick, the button, 

the locator, ana the valuator" 1121. The four virtual dev- 
ices are defined below: 

A. A d i c < is usea to designate certain objects. The user 
will often neec to ooint at objects, just as a person 
may ooint his f i n aer to denote a particular olace or 
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t h i nq 



B. A button is for o r oa r amm a t i c control -- such as 
select inq a oarticular action from several possible 
actions, (commonly a function kevboaro) 

C • A locator allows the user to locate soecific points 
within his defined image space, (commonly a tablet* 
joystick, or mouse) 

D . A valuator orovides toe caoability to determine a 
particular value from some defined real space. 

Thus in design ina a user-oriented system, certain 
hardware selections/interface decisions must be performed 
orior to embarking on the software suooort design. 

The design of a user-oriented qraoh i cs software system 
must provide the full caoability of the araohics device, 
satisfy the user, and not overload the lost computer. To 
achieve these deals, a toe oown acoroacn seems most 
appropriate while maintaining a constant focus on user 
reauirements. To realize a successful cesign of a graphics 
software system the des inner must choose a suitable imple- 
mentation lanouaae, crovide adeauate software support func- 
tions, develop detailed documentation, and finally implement 
the lesion and perform detailed testing of the package. 

The authorities on computer qrapnics today see two 
feasible choices for Graphic language selection. A graphics 
language may oe developed for the specific device or an 
high-level lanouaae, supplemented by a library of 

1 0 



existing 



suoroutines, may be emol eyed 



The des i goer 
device dependent 
tions to a subset of 
languaae will often 
ing for increased effiency. 
found that the design ano 
pose graohics lancuaae often 
experience to the desianer 
In addition, the development 
reauires a great deal of 
and often snowballs into 
endeavor • 



a soec i a 1 ouroose , 
directing his atten- 
oooulat ion. Such a 
while s t r i v - 
it has been 
special pur- 
of a learning 
useful tool to the user, 
a language invariably 
in 1 anouage structures 
a costly and time consuming 



who elects to previae 
1 anauaqe is normally 
the entire user 
employ peculiar constructs 
In previous studies 
implementation of a 
provides more 
t h an a 
of such 
expert i se 



The most common approach to utilizing qraphjcs e a u i p - 
ment is to build around an existing 1 anouaae and generate 
CALLS to a set of subroutines resident in some library. The 
host language must provide the necessary facilities , sup- 
port the appropriate cata structures, and possess an effi- 
cient suoroutine call canaoility. If suer a languaae exists 
in the design environment, strong consideration should be 
given to employ i no it as the base language for the graphics 
system. 

having considered all notions and selected a base 
language upon which to build the graphics system the focal 
ooint of the des i an process must oe shifted to the logical 
formulation of the graphical primitives reouired bv the user 



copulation. William M . Newman and Robert F 



Sproul 1 
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profess that "the only araphical primitives that the pro- 
grammer needs are functions to define o o i n t s / lines and 
display text strings". These basic primitives certainly pro- 
vide the most funaamental set of tool Sr but by offering 
selected options to the user a less hostile and more flexi- 
ble system may evolve. 



Tne foundation, navi no been envisioned and loqically 
designee, should/ wnen plausible, be expanded to provide the 
user with a powerful set of t i oh -level tools. The direction 
of this expansion is necessarily precipitated oy the ouroose 
for tne aracnics system. This process may provide a very 
precise set of functions in the design of special ouroose 
systems, or a number of tas< oriented functions wnicn 
emphasize overall system Generality. Each new function 
spawned by this expansion must provide the user with a new 
and powerful, vet sircl e / tool. 



Documentation must Parallel the entire design process. 
A vitally important cart of this documentation effort is the 
creation of a detailed user's manual. This user's manual 
should be virtually complete prior to the implementation and 
testing phase. The designers have tnus stated how tne ulti- 
mate system is envisioned. 

havina reached this plateau, the implementation and 
testing Phase begins,’ out the documentation effort must con- 
tinue in parallel. In the end, the complete set of 
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documentation efforts must include a detailed user’s manual, 
documented source code, synopses of functions, and a trace 
of the entire process. 



The implementation and testing phase pea ins with the 
creation of the actual software to perform the proposed 
actions. As this software comes into ceing, detailed testing 
must oe performed to ensure that it functions as envisioned. 



In summary, the designers must 
established plan for tne development of 
system. In the absence of sucn a olan, it 
able that the resulting system will fall 



follow some pre- 
a graphics software 
is almost inevit- 
short of its expec- 



tations 



LANGUAGE SELECTION 



III. 



As crev i ous 1 y stated tnere are two plausible choices in 
selecting the 1 a n a u a c e to support a user-oriented graphics 
system* This choice is driven by the ultimate purpose of the 
system^ time/ ana money- Tne system designers may develop a 
new lanauaae tailored exclusively f o n the aevice/ or utilize 
an existing high level language augmented oy a library of 
functions for control of the device. Regardless of t * 9 
course of action the selection should " provide a language 
which is natural/ and which does not add to the boredom, 
panic/ frustration, ana confusion of the user" tl?l , 

1 h e environment for the design effort associated with 
this work was for the most oart academic and reouired great 
flexibility and Generality for tne widely varied user popu- 
lation- The users of the projected svstem would come from 
all bac<arouncs and with an infinite s^t of reaui rement s for 
the svstem. D,u e to this need for extreme flexibility a 
search began to find a suitable high level language to meet 
the reaui rerents* 

The possibility of constructing a unioue lanquaae to 
support the system was r u 1 p d out almost immediately due to 
the time constraint of the effort- Lack of time was cer- 
tainly a valid reason in itself/ but other factors also 



deemed this course of action unfeasible. The goal was flexi- 
bility/ and almost always a new lanauaqe Decodes directed 
to a subset of the user oooulat ion. Tne developed system 
would require on station software maintenance and would 
receive little or no attention if it existed as a new and 
foreign 1 anguaae. 

Havi na made the basic choice to utilize an existing 
high level 1 anguaae the search began for an acceptaole one. 
The Naval Postgraduate Scnool Comouter Laooratorv hosts the 
eouioment and as such its caoaoilities ana restrictions were 
considered in detail. Tnere * e r e several 1 anouaaes commonly 
in use wit n in the confines of the laooratory ( C / Fortran, 
Basic). The most widely used of all the languages was C [3] 
and as such research was initiated to ascertain the feasi- 
bility of this choice for the orooosea system. 

The C programming 1 anquace was well documented and 
allowed the user to write clear and concise programs. It had 
nice control caoaoilities m a < i n c it a very reaaau 1 e 
language/ ana it allowed the user to write coae that is very 
compact out still clear. The language encouraged a modular 
design ana provided all of the necessary constructs to 
implement a viaole graphics system. The fact that the 
language was commonly used cy oersonnel involved in research 
within the confines of the laboratory was another plus for 
selecting it for tnis application. The feeling was that the 
C programming lanauage would support a coro lately flexible 
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and general ouroose araonics system; thus the decision to 



i rnol ement the system with it as tne base programming 
1 anguaoe was made. 

A software supoort oackaqe existed for the RAMTEK 118] 
at the onset of this research effort / Out its configuration 
was unacceptable oasec on tne research to this Point. From 
previous studies it was learned that a high level languaae 
supported bv a library of functions was the most common 
approach to utilizing a Graphics device. The existmq 
software support oackaae did not resemble this basic design 
philosophy, as it existed as two very large clocks of object 
code. Peoardless of the size or needs of the user program 
these two blocks of code were merely appended to the com- 
piled program resulting in a very large execution module. 
This implementation technique was found to be completely 
unsatisfactory from a design standpoint. 

having decided to use the C programming language and 
real i zina thar the existing software support’s organization 
was not in compliance with the prescribed goal s^ the next 
step was to develop the structure and organization cf a set 
of 1 i Drary support functions to oroviae for specific support 
of trie device. A aetailec analysis of the existing system 
was initiated. Tne system was found to provide the basic 
capabilities and modular design that was felt would be 
requi r«a. The decision was made to base tne new supoort sys- 
tem on the C programming lannuage plus a library of rudimen- 
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tary functions sec urea from the previous software support 



system. 



Prior to emoar<inq on the task of building such a 
library^ the UNIX ooerat i nq system constraints were invesi - 
gated to reveal the crooer library structure. This environ- 
mentally imoosed structure was a major concern as the 
development process began. The reason that no previous 



attempts nao been mace 


to 


provide 


tne 


envisioned structure 


«as t n a t it 


was to o e qu i 


t e 


t ed i ou s 


and 


oos s i b 1 v 


r eau ire a 


great aea 1 


of redesign. 


I n 


the U i\ I X 


en v i ronment 


the library 


is searched 


seauen t i a 1 1 y 


from start 


t 0 


finish to 


resolve any 



undefined references from tne compilation of a user program. 

This linear search orocecure employed by the host sys- 
tem dictates that the liorary have a very precise structure 
if it is to be efficient. As the library searcn is performed 
all references bv internal functions must be forward to cir- 
cumvent the necessity of multiple searches of the same 
library. Failure to organize the library around this very 
real constraint coul o result in very inefficient utiliza- 
tion. To organize the rudimentary library in such a way 
required indeoth stuov of the existing software. 

The ex i st i no software suoocrt package was studied in 
detail to determine/ -without exception, the precise func- 
tioning of each module. It was paramount to explicitly learn 
the path of function calls from each of the existing pro- 



cedural functions. This information was found to he best 



depicted in t a o u 1 a r format 



A taole of cross-references for each function was con- 
structea. This taole ultimately displayed the calling 
sequence for each function ana what functions called it. 
This organizational steo provided the insight reauired to 
beain to organize the 1 i Drary , Had the original design 
employed a library in the 1 anquaae decision orocess vice two 
large " programs 11 tni s steo could have been eliminated from 
this design. The fact that the new user-oriented desicn will 
be in a library will facilitate more efficient software 
maintenance and s i ani f i can t 1 y reduce the size of the user's 
execution module. 



The existing oackaae was written in the C programming 
language and/ as such, fitted the proposed language imple- 
mentation techni cue cuite well. Thp structure having been 
exposed/ the task was to build a fundamental support library 
from previously developed software. Fne functions were 
further researched to see 1 * out which variables were used by 
each function. This orocess was most involved/ but neces- 
sary/ as the environment of UNIX allowec for only singular 
initialization of each variable. 



An organizational chart was developed to ascertain 
where and when initialization of each variaole was to take 
olace. Once the variables had been laid out in a logical 
initialization seauence/ t h e actual building process could 
be embarked upon. The conceptual design could be seen as a 



1 



feasible t as * / 



but an explicit layout of the proposed 



library had to be ^aae ana manually verified. The structure/ 
to be efficient/ had to oossess no backward references and 
oroviae for singular initialization of all variables. 



The base library was nesianed and implemented. After 
detailed test i nq it became apparent that the new concept 
performed better than the old even though there were no phy- 
sical improvements to the software functions themselves. The 
library provided much smaller execution modules/ as only the 
user-requestei functions were appended/ not the entire pack- 
age as was previously the case. This newly structured 
library also possessed the benefit of ease of maintenance 
and expansion. This represented a major step in the overall 
goal of the project. 



The first steo in the design of a use r-o r i en t ed araph- 
ics system had been accomolisned. An existing language sup- 
ported ov a liorary of subroutines had been chosen for 
implementation of the system. Had this step been performed 
in the original investigation a more viable and maintainable 
system would have existea from which to aecart. It was felt 
that this structure provided maximum flexibility/ efficiency 
and created a firm case from which to oroceea toward a 
user-oriented system. 



DESIGN OF SYSTEM FUNCTIONS 



I V . 



The trend in the development of graphics software sys- 
tems is towara h i a h - 1 e v e 1 software support oackaaes that 
provide s i m o 1 e / powerful controls over the caoaoilities of 
the system/ yet shelter the programmer from the low-level 
features of the hardware. The design of the functions that 
make uo these software cackaaes oleys a vital cart in deter- 
mining the success or failure of the system as a whole. 

In the environment discussed here/ the oasic machine- 
level interface (the "driver") oetween the host computer and 
the graphics oi sol ay device had oeen installed. In addition, 
a ' number of software routines had oeen written for the sys- 
tem. There was no organized library of system functions. 
Instead, all of the written routines had been conglomerated 
into two files/ including a very larce sample program, Tne 
requirement to crinc ooth of these laroe files into memory 
for every program's execution was corsi oerpo unacceptable by 
established desian standards. 

It was decided at this point that the most realistic 
approach would oe to moaularize the existing functions, 
oraani ze tnen into a prooerly formatted library structure, 
and thoroughly analyze this packaae for content and func- 
tional capability. The desian and development of this system 
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library was discussed in " LANGUAGE SELECTION 



The ensuing analysis of existing routines revealed many 
shortcomings that reouired either modifications to the 
existing code or a complete redesign of that oarticular 
function. In addition, the software oeckaqe as a whole aid 
not offer the user the full capabilities of tne system as 
envisioned by the aesianers. As well as not providing the 
full capability of the device/ the system was severely lack- 
ing in interactive tools* The system did not provide suffi- 
cient control ana communication facilities for the user. 
Numerous additional functions were designed/ created/ anc 
implemented for this ouroose. 



This nhase of the lesion crocess was not a purely 
creative exercise* It was a case of the designers overl ay i no 
the existing software with e " template" or "mold" of the 
system they envisioned; then modifying/ restructuring/ ana 
expand ina the existing packaae to fit this mold* Tne system 
functions that evolved from this "modified" desian process 
are presented in detail in the User’s Manual (Appendix A). 



The inclusion of an increased interactive capability 

involved the locical design and creation of avenues to 

* 

facilitate a more symbiotic man-machine communication sys- 
tem. The only external device availaole to the user was the 
keyooara. A basic Graphics system can survive with only this 
capability/ Out shoul c not oe restricted to this device wnen 
the Possibility for expansion exists* A concerted effort 



then began to provide the user with a flexible communication 
medium. This medium was the Vector General Data Tablet. 

In devel oni nq this interactive tool to its fullest/ tne 
intent was to aive this one physical device the capability 
to appear as four virtual devices (nick, Dutton* locator/ 
valuator). Tne pick ana locator functions coulo ce satisfied 
via a tablet driven cursor. This caoabilitv became one of 
the goals of the software design. The tablet could also ful- 
fill the valuator function orovided it could take on vari- 
able dimensions/ ana dive the user the anil i tv to select 
values from witnin tnis soace. Finally/ the tablet could be 
broken into user-definea switc h es that could resoond as Dut- 
tons or function switches for orogranmat i c control. 

6y logically envisionina the tablet as discussed above/ 
it provided a nice complement to the R A M T E K keyboard. The 
user/ now having two interactive devices at his disposal/ 
would enjoy a more flexioie communication interface w i t n tne 
machine. 

A cross-sectional vie* of the software support cackace 
would reveal a structure of "tiered complexity " . At the base 
of this structure would lie the oasic primitives for a 
graphics system*s operation. Some of these routines are only 



one step removed 


from 


machine 1 a n a u a a e instruct 


ions 


. These 


primitives 


f 0 r m 


the 


t ounce t i on 


for hiaher 1 


e ve 1 


funct ion 


deve 1 oomen t / 


but 


must 


also be made 


access i b 1 e 


t 0 


the more 



advanced users' programs. The n°xt level in the structure 
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would oe comprised o * more definitive Graphics applications 



functions. ^ost users could accomplish all their desired 
work at this software level/ but it would likely require 
numerous and reoetitive calls to these functions. The 
high-level functions that form the crest of this structure 
are directly supcorted ov the first two levels. These are 
the functions that offer the user more powerful / Problem- 
orientea options. 

This asoect of three levels of graduated potential was 
applied to each of the functional areas or control modes of 
the R A M T E K curing this d e sian/evaluation phase. This was 
also the approach usee to ensure that the full range of 
color manipulation capabilities were availaole to the user. 
Thus as each basic hardware capability was investigated/ the 
associated software tc exploit that capability was logically 
designed and conceptually aligned with this structure. If 
the existing software did not conform to this view or aid 
not function to the envisioned specifications for tnat par- 
ticular machine capability/ it was modified and/or expanded 
to do so . 

Most of the modifications that were required were to 
functions of t n e first and second levels. For instance* t n e 
procedure for select i no a particular color entry (from the 
current color table) was poorly implemented. This function 
Had to be completely redesigned to achieve the proper 
results. Likewise/ the routine that existed for the Purpose 
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of establishina a starting ooint for generating any display 



had not taken 


into 


account certain 


c on t r o 1 


mode/cont ro 


1 flag 


c omb i n a t ions 


t n a t 


reaui re 


more 


than one machine 


-level 


instruction 


t o i 


n i t i a 1 i z e 


the 


P r ooe r 


reg i s t e r s . 


Minor 


corrections cr 


i morovement s 


r e 


m aoe to 


numerous 


other 


functions in 


the 


f i rst two 


s t r a t 


a of the 


design structure^ 



primarily in the areas of manoing virtual screen addresses 
to real screen locations, and Performing error checks. 



The majority of n e * functions that were cesigned and 
created curing this process wer^ h ion-1 evel functions aimed 
at improving over-all system performance. During the evalua- 
tion of the color display tecnniaues, it was recognized that 
a user could snend a great deal of time in generating t n e 
exact colors he desi rea for a particular ai splay? yet he had 
no way of saving these color combinations for subsecuent 
use, since the system color tables ere automatically ini- 
tialized upon each new access to the aevice. This forced the 
user to regenerate his colors at each session on the ecuio- 
Tient - - a time consuming task. This capability of preserving 
user-aefined colors between intermittent sessions * a s viewed 
as -an absolute necessity. Thus two new functions were 
developed : one to coov the status of current color taoles 
into a file in the user’s directory, ana one to subsequently 
restore these colors nac< into the system tables after ini- 
tialization has ta<en place. 
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Another capability that was found lacking 



and was 



therefore generated during this chase* was the ability to 
simultaneously display multiple alphanumeric character 
strings* such as blocks of text. This function relieves the 
user of the distracting task of making repeated calls to the 
mid- level single strino disolav function. 

By aoolication area* the largest number of newly- 
introduced facilities were in -the realm of Providing an 
interactive caoaoi 1 i tv between the kAi^TFK display system and 
a Vector General Tablet. Add r o x i m a t e 1 y fifteen functions 
were designed in the af ore-rent ionea t i erea structure to 
offer the user a * i a e variety of interactive techniaues. 
The tablet may thus be used for ranioul at ina or Generating 
color tables* directing the movement of a software-generated 
cursor on the display screen? selecting program execution 
options from a menu of loaical tad et Switches? or* with 
prooer aopl i cat i on of lower-level functions* " sketching” a 
display onto the screen. 

The modified design approach that was taken, in con- 
junction with tne t i ereci-sr rue ture view of the software* 
proved highly efficient oy preventing the loss or waste of 
any previously developed functions* while readily identify- 
ing any lack of functional can anility in a particular area. 

The envisioned system ana the newly introduced capabil- 
ities* in order to Provide a truly user-ori entea environ- 
ment* required a continuous reflection on the user and his 
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psychological o e h a v i o r . The user's basic psychological 
requirements are time dependent 1171. The user exoects cer- 
tain responses in a scecific time frame or he becomes frus- 
trated and di sol easel with the system. Each scecific func- 
tion was evaluated for oossiol e unfavorable psychological 
responses. 



The psychological make-uo of the user was of prime 
importance in the actual design of the interactive color 
manipulation routine tabcolorO . This function allows the 
user to interactively modify and/or create system color 
tables. The expectations and possible frustrations of the 
user were researched in detail in this regard. 



Thus the user was recognized to nave certain expecta- 
tions [173; ana a concerted effort was made to ensure that 
the system could adequately meet these expectations. The 
competing properties of efficiency ana simplicity remained 
fundamental considerations throughout the developmental pro- 
cess. 



when Possible^ the system functions were designed to 
employ "interaction by anticipation" 1151. This approach 
decreased the reouirec number of diagnostic messaaes and 
should result in a more satisfied user. 

Satisfactory response times w ®re also considered in the 
over-all system design. It was found that users could become 
frustrated and annoyec by tne improper timing of responses. 
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For example/ 


when a 


user pe 


rforrns incorrect 


i y 


/ the 


system 


shou 1 a not 


respond 


immediately/ but cel ay 


f r o m two 


t o 


f ou r 


seconds . 1 h i 


s delay 


a 1 lows 


for psychological 


c 


1 o su re 


on 


the 


user's part 


/ a f t e r 


which 


time an error indi 


cation 


i s 


more 



acceptable. 



The 


logical 


aesicn 


of system 


funct i ons 


thus i n vo 1 


1 ved 


va 1 i da t i 


on of e * i 


Sting 


software/ 


desion of new 


software/ 


and 


constant 


reflect! 


on on 


the user's 


os vc ho 1 oo i c a 


1 neeas, 
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V 



DOCUMENTATION 



The 


documentation effort 


i n 


this thesis work 


was a 


Con- 


tinuous orocess that oar a 1 tel 


ed 


al 1 


other phases o 


f the 


or o - 


j ec t . The 


tack of sufficient 


p r i 


o r 


aoc umen t a t ion 


was 


con- 


sidered 


as one of the motiveti 


no 


factors oehina 


this 


work. 



This deficit was certainly one of the major hindrances in 
performing the object system design* Therefore/ the formula- 
tion of crooer documentation for this software system, in 
oarticular a well-conceived user’s manual/ was of utmost 
importance to the designers. 



An attempt was made/ throughout tne oesign/evaluation 
orocess/ to record every t i n d i n q , every result/ every 
achievement/ no matter how insignificant it might have 
seemed at the time. These notes, though seemi nql y unorgan- 
ized/ served as valuable reflections during the imolementa- 
tion ana testing phase/ as well as when this writing began. 



It was the ultimate coal of this thesis to 
maximally user-oriented oraohics software system 
by an eaually user-on ented user's manual, 
latter/ the former would surely go unrecognized 
With this in mind/ a creat deal of thouqnt and 
were aevotea to aevelccina such a manual. 



develop a 
accomoani eo 
i t hout the 
and unused, 
orecarat i on 



The result i n q manual ( Aooendi x A) is organized along 
the following lines. First there is an introduction to the 
basic system environment and to the manual itself. Next is a 
guided tour of the steos required to gain access to this 
environment. This is followed bv a tutorial review of the 
basic programming <no*leaae a user should possess to 
apDroach this system with some degree of conf i aence. The 
next Chapter actually beoins to reveal some of the features 
of the graphics oisolay system, and exposes the oasic pro- 
grammatic control functions the user will need. The remain- 
ing chaoters (except the last) are each devoted to one par- 
ticular functional capability or control mode of this sys- 
tem. This will, hopefully, provide a more systematic revela- 
tion of the over-all capabilities and features of the 
display system. 



As each of these areas is explored, the associated sys- 
tem functions are presented in a too-down fashion. After an 
introduction to the oasic ac cl i cat i on a r e a r the hian-level 
functions are i nt rocuceo first, followed by crogressively 
lower level functions. This approach was taken in an attempt 
to alleviate the difficulties of the novice user in gaining 
familiarity witn the system. 



One cnaoter of the manual is devoted to each of the 
primary interactive lev i ces : the R A T E K keyboard a n a the 
Vector General Taolet. Tne final chapter presents routines 
which are not an integral part of any particular functional 
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area; and had thus not been introduced earlier, but which 
might Drove useful in some acol ications. 

Tne individual system functions, in the UNIX format 
[6J, are included as •iopendi x B for further clarification 
and/or review by the user. In addition, a cocy of the source 
code for each of these functions (with exol anatory comments) 
is available in the Naval Postgraduate School Laboratory. 
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IMPLEMENTATION AND testing 



VI , 

A. PREFERRED TECHNIQUE 

Ideally the imolementation chase o > a co^outer system 
design should only account for 2 S - 3 0 % of the total effort. 
The functional desiqn is comolete ana a detailed users 
manual exists for the orooosed system. Actual i me 1 emen t a t i on 
should then consist o * coaina, deouaci nq f and localized 
testing. 

The coding effort should offer little challenge, as each 
function has been laid out in aetail. It snoula be merely a 
translation of ideas into a suitable medium for the com- 
puter, The decugoinc of each function affords more of a 
challenger as without fail loaic errors will exist in the 
basic design. 

As the debugeing process begins the documentation must 



be keot current 


or in 


t n e 


end tne documents will 


not 


accu- 


rately depict 


the 


system 


as 


it actually performs. 


If 


ciocu* 


mentation and 


real i ty 


ever 


begin to diverge then 


an 


unten* 


able situation 


i s 


1 i k e 1 y 


t 0 


be createdr in the form 


of an 



unmaintainable system. 

As functions are brougnt on-liner local testing will be 
conducted - - local testing bei no those tests cerformea by 



the oerson responsible for a oarticular functions 



i mo 1 emen - 



tation. The problem with this local testing is that often 
the testor is too close to the problem to oroviae a good 
test. After the local testing is complete* the detailed 
testing of the function should be performed. 

This detailed testing should be oerformeo by some person 
or preferably some group of persons who nave no stake in the 
success or failure of the system. Ideally this testing will 
be done by a team which woula soena as much time and effort 
developing the test clan as went into the design. A]l too 
often this last microscocic testing is omitted* with the end 
result being a system full of implicit assumptions and 
surprises for tne unsuspecting user. 

B. MODIFIED TECHNIQUE 

The preferred technique could not be acpliec to this 
effort and was thus modified to meet certain restrictions 
and needs. Hcoef ul 1 / the end result was the same - - leaving 
a viable and truly user-cnentea system. The reasons for the 
modifications were that a test team for the thesis was 
unrealistic* ana that an existing system afforded a point of 
departure in search of the user-or i enteo svstem. 

1 .’ V ALID AT lOfo/CQNDEVNA F I ON 

Due to the fact that a software supoort package was 
already in existence for the R A M T E h this modification was 
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injectecu It amounted to havinq three erases oeing performed 
simultaneously. The three Phases were FUNCTION DESIGN, DOCU- 
MENTATION, ana TESTING. 

While operating in oarallel, as Proposed functional 
requirements were enumerated, the existing software and its 
associated documentation were searched to determine if such 
a function already existed. Tf the existinc system possessed 
such a function then the v a 1 i da t i on / c onaemn a t i c n process 
began . 



This orocess * a s fundamental, as it eitner validated 
the performance of the function or it caused it to oe con- 
demned. The orocess, thou ah simple conceotually, was one of 
the most difficult and time consuming stages of the systems 
evolution. If the function performed exactly ' "as adver- 
tised”, then the action was to merely document and continue, 
when the function die not act as expected, then the often 
lengthy ana involved search began * o r the sometimes illusive 
logic error. 



The need tor 
certainly created Dy 
tern. This i naoeauate 
tern to fall prey 
thought of using a s v 



this unrewaroi nq exoer i ence was most 
inadequate testing of the previous sys- 
testing ha a also caused t h ^ " old" svs- 
to idleness, as users do not relish the 
stem full of frustration and surorise. 
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2 . 



IMPLEMENTATION 



The funo^mental succort functions of the predecessor 
to this user-oriented systerp had been installed and tested 
prior to the start of the i mo 1 emen t a t i on phase of the moci- 
fied approach. The volume of change was small when viewed 
against the entire system, but essential in a truly user- 
oriented s v s t e m . 

The actual cocinq effort of the selected additions 
to the now deoendable case system only accounted for acorox- 
imately t 0 % of the total effort. This chase was actually 
conducted exactly as discussed in the PREFERRED TECHNIQUE 
section. Once the coding/ debuooina, and localized testing 
was complete/ tnen detailed system testing began. 

3. DETAILED TESTING 

The beta i lee testing of the overall system was con- 
ducted in compliance with the oreferred technique. T n e use 
of an external testing source was not feasible/ thus these 
suggestions were cent sliahtly to accomodate the cir- 
cumstances of the design. 

The dual thesis effort afforded a viable test via 
oscillation duties between designers. The person respon- 
sible for the actual implementation of a function was not 
responsible for it’s testing. Thus the designer’s counter- 
part became tne a evil's advocate durina the formal test 
phase. 
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In aadi t i on tc the formal test i no, user testing was 
not only encouraged but souaht . Tne system* when possible* 
was made available to users - - reauestina that they convey 
their likes and dislikes* successes and failures. The sys- 
tem* having been designed for the user* was then evaluated 
very critically from user comments. For the most part 
response was favorable, /ihen unfavorable responses occurred 
they were studied* anc every attempt was mace to restructure 
those aspects that were found to be distasteful. 

tt . COM fINUED TESTING 

In order for a svste^ to really claim to be user- 
orienteo* it must ce placed in a continual test Posture. 
This continual testing is informal but allows for response 
to user criticism. The user is afforded the facility for 
voicing his Problems with the system. These user assessed 
problems m ust be evaluated and acted upon. The action need 
not be drastic* ill-advised system modification* but an 
honest look at the oroolem. If corrective actions are in 
order* then tne documentation and software must be modified 
in unison. 

The R A M T E K GX-1G0A araphics support system is 
currently installed ana undergoing tne continued testing 
ohase. There are no known oroolems* but the facility for 
voicing such oroolems exists in the form of a trouble report 
attached to the device. 
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RECOMMENDATIONS 



VII. 



The system^ as configured# should now offer a produc- 
tive develoorr, ental environment. This newly created environ- 
ment will# hopefully# encourage fresh innovative research in 
new applications of color Graphics. Two such areas surface 
almost immediately as 1 i < e 1 y candidates for meaningful 
research. These two areas are: 

COMMAND# CONTROL# AND COMMUNICATION; ano 
SIGNAL PROCESSING . 

Tne command# control# and communication applications 
are bounced by imagination alone# as this fielc is still 
evolving. The field of computer graphics will most surely be 
one of the front-runners in the i rol e^entat i on of such sys- 
tems. The color capabilities of the R A M T E K should provide a 
powerful tool in tnis r e a a r a . 

Limited signal process inn applications have a 1 ready 
been performed on the device. Tne new system should 
encourage more use of color in this area. The color display 
will most certainly ccnvev more useful information. 

In addiMon to the new applications# it would De bene- 
ficial if the saving of complete screen images were possi- 
ble. The memory space reauired for this application would 
require serious consideration out could be arranaea to 
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permit efficient utilization. The memory readoack interface 
was not installed on this equipment* out with its installa- 
tion ana minor software efforts it would be possible to 
memorize screen images. This memorization process could 
eliminate tne need for repetitive orocessing while providing 
a powerful tool for the user. 

The support library exists as a separate entity and is 
intefaced via the C crcaramminc lanauage. Possible research 
on the capaoility to access this Horary via ether languages 
would be a worthy experience. 



The ever continuing maintenance of this 
systems is of .the ‘utmost importance. Similar 
ducted on the P A w T E K could oe undertaken for 
devices in the 1 aboratnrv . 



and all 
e f f o r t s 
other 



of the 
as con- 
gr a P i c s 
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VIII. CONCLUSIONS 



An existing software suoport o a c k a g e was disassembled, 
then restructured^ tested, and expanded into a usaol e color 
graphics display svstem. The goal, as a user-oriented sys- 
tem, was achieved; out the design approach and the solutions 
to problems encountered offered the real lessons in this 
learning process. These were the most important results to 
the designers. 

In recesionina a software system based on a prior 
design, it was possible to have 20/20 hindsiaht into the 
failures of the previous attempt- The most profound judge- 
ment derived is that detailed planning must precede imple- 
mentation efforts. The parent system that soawnec this 
user-ori enred child was not planned in aetail nor well docu- 
mented. Had the stecs utilized in developing this n e * design 
Deen employee in the previous effort, tnere would Probably 
have oeen no need for major revision ana exhaustive testing. 

Ihe system has oeen installed anc tested. Adeauate 
documentation has Deen provided to assist users in the effi- 
cient use of the device. 
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APPENDIX A 



USERS MANUAL RAMTEX GX-100A 



This manual 
graphics d i 
t ion to the 
vest igat ion 



is aesigned to provide the users 
splay device a convienient and 
aevice. The manual allows for as 
into the system as the user desi 



of the R A M T E k 
simple introduc- 
detailed an in- 
res. 
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INTRODUCTION 



The K A M T E K G X - 1 0 0 A graphics display system utilizes a 
raster scan techniaue# with the disolav image data being ex- 
tracted from an internal refresh memory. The RAMTEK system 
in the Naval Postgraduate School Computer Laboratory is 
hosted oy a PDP-11/50 computer and is accessed through this 
computer# ana its UNIX operating system# from one of the 
terminals in tne Lao* 

It is not the intent of this manual to orcviae a de- 
tailed analysis of the hardware or internal functions of the 
RAMTEK device# but rather to excose the user to the software 
support p a c < a g e that has been aeveloceo for it. This 
software package consists primarily of a system library of 
subroutines written in tne ' C 1 programming language. Includ- 
ed in this liorary are a number of routines that enable the 
user to interface the R A ,v T E K with the Vector General Data 
Tablet in the Lab. 

A review of the Table of Contents would reveal the 
basic organization cf this manual to oe as aescribea here. 
Following this Introduction is a chapter devoted to fami- 
liarizing the user with the environment in which this Graph- 
ics system exists. The next chaoter presents the fundamen- 
tal programming knowledge reauired of a prospective user. 
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Following this/ the basic control functions of this system 
are aescribea. Next the user is introduced to the data ta- 
blet interfacing routines/ followed by color manipulation 
techniques. After this/ there are eioht chapters that each 
describe one of the control mooes of the GX-100A. Then comes 
a chapter detailinc the use of the interactive keyboard. Tne 
final chapter discusses the remainder of the software sup- 
port oackage. A here appropriate/ the separate chapters are 
divided into three sections : Introduction/ basic User 
Guidelines/ ana Advanced Methods. 

The manual will serve as a tutorial on tne subroutines 
available to the user for aereratina displays on the K A M T E K 
terminal. There are numerous sample programs included to al- 
low the user to become familiar with operating the system 
and to exhibit certain features that are available in the 
R A f v » f E K software support o a c k a a e . These sample orogranS/ 
alona with several laraer demonstration programs/ have neen 
compiled into a special directory in the host computer file 
system (see Operating Instructions). The user is encouraged 
to execute each of these samples as he progresses through 
this manual. 

For the user that reouires a more detailed knowledge of 
the internal functioning of the device/ tne RA^TEK G X - 1 G 0 A 
Programmi no M anual [1] is available in tne Lab. 



Black & White 
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OPERATING INSTRUCTIONS 



The PAMTEK display device is accessed via the "'A” sine 
PDP-ll/bO in the Computer Lab by using one of the terminals 
connected to this computer. If the user is not familiar with 
the operation of these terminals/ he should consult the Ter- 
minal User's Manual (21 available in the Lao. 

In order to utilize the R A M T E K , the device must be 
"cowered’on" and supported by the PDP-11/50 computer. By 
following the 12 steps listen below, tne user will ensure 
himself of a successful session with the equipment. 

1. Ensure the "A" sine PDP-11 comouter is in operation. 
(If in doubt/ check with Lab staff.) 

2. Check the green oower supply light/swifch (marked 
" R A M T E K P 0 Vl E P ” ) at the lower rear of thp host PDP-11. 
If this switch is NOT illuminated/ contact one of the 
Lab personnel for assistance. Indiscriminate use of 
this switch will cause the host system to "crash". 

3. Apply power to the R A M T E K kevboaro and monitor : 

a. the green " P 0 E R M switch on the upper right por- 
tion of the keyboard should re illuminated; if 
not/ depress tne switch. 

b. select the "ON" position o * tne selector <nob at 
the lower left corner of the color display m o n i - 
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tor. (See Fig. 1) 



c. (optional) select the "ON" position of the power 
switch on the lower front Dane! of the black & 
white monitor (See F i q . 1) 

a. (optional) select the "ON" position of the power 
switch on the Vector General Data T a o 1 e t . 
a . Choose one of tne " A " side terminals and turn it on. 

At this point/ the user is reaay to log into the UNIX 
ooeratina system ana proceed with the session. The user that 
intenas to execute one or n o r e of the sample programs from 
this manual or view ere of the R A N' T E K demonstration programs 
should continue with stec S . For the user that has been es- 
tablished in the system with his own identification ana 
directory/ the most common activity is program development 
and testing* This user is assumed to be familiar with the 
operatina environment and is referred to Cnapter IV, Pro- 
grammatic Control of the RAN. TEK. The user with only moderate 
experience in the UNIX environment may wi sn to scan Chapter 



III/ Basic 


Proaramming 


Reoui rements/ 


before 


proceeding to 


Chapter IV. 


I^ese users 


may return 


t 0 


step 


1 0 


below for 


termination 


croc ecu res . 












5 . At the 


selected terminal/ the 


completion 


o f 


the f o 1 - 


1 o w i n a 


sequence 


will lead 


the 


user 


t 0 


the system 



directory that contains the sample and demonstration 
programs (note : lower-case type implies a user-tyced 
command/ uooer-case tyoe denotes a system reply/ " % " 
is the UNIX prompt signal/ and "c/r" means depress the 



PETU^N key) : 



LOGIN: cs2000 



c/r 

PASSWORD: student c / r 

% cd ramtek c / r 

to . To determine what source programs are available for 
inspection# the user should type : 

Is * . c c / r 

This will result in a listing of the names of all 
files in the cs2Q0 0/ ramte‘< d i rectory that are of tvoe 
M • c 11 . This list of file names will eopear on the ter- 
minal screen. The files that are named ol.c throuoh 
o 2 0 . c are sample programs tnat are described later in 
this manual. The other files listed are of no concern 
to the user at this time. 

7 . To insoect one these files# the user should tyoe : 
list - c filename. c c/r 

c / r 

where " filename" 'denotes the- name of the particular 
chosen file. The second (ana subsequent) M carriage 
return” will cause the next "page" of source code to 
be printed on the terminal screen. For example# to 
inspect the source cod p of the first sample program# 
the user would type : 

list - c ol.c c/r 

8. To execute one of the sample Programs and view the 
resulting display on the R A m T E K , the user should type: 
filename.x c/r 

is the na^e of the selected sample 
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where ” filename 



program. After decressina the RETURN key/ the user 
shoul a turn his attention to the aisnlay screen, 

9 . In addition to the sample pro a rams mentioned above/ 
there are also four demonstration orograms in the 
cs2000/ramtek directory. A detailed exol anat ion of 
these demo programs can he found in the " User Entry 
Manual H (21. Tc view the first of these demonstration 
programs/ the user should type : 
rami c / r 

Subseauent demo orograms are cal 1 eo ram2/ ram 3/ and 
r a m 4 . These demo orograms offer the user the opportun- 
ity to interact witn the R A M T E K keyboard ana the data 
tablet. 

After completing the desired work for one session/ the 
user should proceed tc step 10 for termination procedures. 

10. For tne user who is currently editing a file (ie, 
creating or modifying a file in his own or a class 
directory)/ care must oe ta*en to ensure the latest 
additions/corrections are incorporated into his pro- 
gram. This is accomplished cv typing at tne terminal : 

w filename c / r 
Then typing : 

a c / r 

will get the user out of the "edit" mode. (see Chap. 

Ill ) 

11. To terminate tne session on the terminal/ tvoe : 

Quit c / r 
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1 . To "sower down" the R A v T E K , the following steos 

should be accomolished : 

a* Turn off the green sower switch on the RA^TEK 
keyboard by depressing the switch. 

b. Select the "OFF" oosition of the selector knob 
at the lower left corner of the color display 
m o n i tor. 

c . If the black $ white monitor is on/ select the 
"OFF" oosition of its oower switch on the lower 
front canel. 

0. If the Vector General Taolet was being used# 
select the "OFF" oosition of its oower switch. 
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BASIC PROGRAMMING REQUIREMENTS 



III. 



In order to utilize the PAM] Eft aisolay device the user 
must have access to the comouter laboratory and a login name 
in the UNIX time shar i na system. The fact that the user is 
estaolished in the UNIX ooeratinq system allocates the soace 
reauirec for croaram cevelocment . There are two separate 
POP- 11/50 comouters in the laboratory ana they are referred 
to as the " A n and " 5 H sides. The " A " sice hosts the graohics 
display devices of the laboratory; the ” 6 " side is usee for 
general crogram aevelocment. In order for a user to effec- 
tively utilize the svstem he should have access to both 
sides . This allows the user to create and oebug proorarr, s on 
the '* 8 " side* then execute the oroarams on the " A '* sice. 



The C orocramming language (31 «as used to develoo the 
software suocort for the P A M I E K and, as such, the user will 
be required to orooram in C in order to interface with this 
software. Tne C lanouaae is similar to FORTRAN out orovioes 
a oreat deal more flexibility. A C orogram consists of data 

declarations and one or more functions. This language nas 

, » 
five fundamental data tyoes: 

int (integer) 

char (hyte) 

float ( s i n a 1 e precision floating ooint) 
double (double crecision floating ooint) 
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reaister (sa^e as i nt excect in a register) 



Declarations may be made internally or externally, with 
respect to a function, indicating either local or Global 
scope respectively. Global scope implies that the variable 
is known to all functions that follow; local score implies 
that only the function that contains the Declaration has 
knowledge of that variable. 

A function consists of a set of statements enclosed in 
braces ({}). Every C program must contain a function called 
"main’ 1 since execution of a C program begins with the first 
statement of "main". All functions must be explicitly de- 
clared (including M m a i n " ) oy a statement of the form : 
f unc t i on -n ame ( oc t i on a 1 arguments). Tne optional arguments 
are the wav that data are communicated between functions. 
The arguments must be enclosed in carer t ^es i s and, even if 
no arguments exist, the carenthesis must always be present. 
The statements within a function are always terminated with 
a semi-colon and, as oreviously stated, the boav of the 
function is enclosed in braces, "^ain" will normally invoke 
other functions to perform certain tas<s; this is a c c o m - 
oli shed by stating the function name followed by the argu- 
ment list ano terminated bv a semi-colon. 

with this very cursorv loo< at the C orogramming 
language the user should be aole to understand the example 
programs o f this manual and write simple C programs. The 
user is encouraged to reao tne C tutorial 14] ano the C 
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reference nnanuel 1 3 ] for a more detailed description of the 



1 anguaqe 



It is assumed here that the user has some knowledge of 
the UNIX ooerat i ng system, at least to the level of having 
read the " UNIX for Beginners’* tutorial C51. Thus he will 
understand that files may be created by invoking the UNIX 
TEXT EDITOR, diving the command to aooend information to the 
file, inserting the information, terminating the append 
mode/ ann writing the file. T h.e following short exercise 
should refresh the users memorv. 

LOGIN: "user login name" c / r 

PASSWORD: "user oassword" c / r 

ed samole.c c/r (invokes text editor) 

a c/r (enter aooend moce) 

ma i n ( ) c/r 

{ i n t a / o , total; c/r 
a = 1 ; b = 2 ; c/r 

total = a ; c/r 

orint f ("sum is %d0, total); c/r 
} c/r 
. c/r 

w c/r (write file) 

q c/r (ouit edit noae) 

This example creates a ^ i 1 e (C program) called samole.c 
that, when compiled and executed, sums two integer values a 
and b into total ana then prints the result. 
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The user should recall that in order to compile a C 



program he must invo'<e the C compiler by using the "cc" com- 
mand. To compile the above example the user would tyoe : 

c c samel e . c c / r 

The result of a C compile is an executable file named a. out. 
This file is created if one ooes not already exist or re- 
places the old a. out file if one existed previously. In ord- 
er to save an old a. out file the user may rename it bv util- 
izing the UNIX function For the user to save the a. out 
file created by compiling samole-c he could tyce : mv a. out 
sample c / r . This cnanges the name of a • o u t to sample. 

having been refreshed on the very basics of the C pro- 
gramming 1 a n a u a o e r UNIX/ and compilation procedures/ the 
user is reaoy to begin writing/ compiling/ and executing 
programs specifically for the RAMTEK graphics display dev- 
ice. The user-oesi cnec oroqrams f o r the RAMTEK will be 
dependent uDcn the RAMTEK software support library. This li- 
brary contains a multitude of user oriented routines that 
allow him to perform certain tasks on the device* These 
routines are actual 1 v C functions ana in order to invo<e one 
the user must only mention it’s name. Since this support 
routine is not within the user defined C program/ it is un- 
defined unless a link is provided to the sucoort library. 
This 1 i n < is provided via a shell command called " ramtek". 
Thus in order to compile a oroaram that references functions 
contained in the licrary/ the user types : 



ramtek filename. c 



c / r 



This will issue a "cc" command with the aDDroofi ate parame- 
ters to link to the software supoort 1 iorary ana resolve tne 
previously undefinea function calls. The following e x a m o 1 e 
typifies this procedure: 

LOGIN: "loain name" c / r 

PASSWORD: "user password" c / r 

ed CT5.c c / r 
a c / r 

ma i n ( ) c / r 

(ramtekU 1 erased ! c / r 

d i so ( 7 ) ; c / r 
)• c / r 
. c / r 

w c / r 

a c / r 

ramtek CTS.c c/r 



The 


result o f tne aoove 


example * i 1 1 


o e tne 


creation of a 


file 


C15.c (the source 


code ) an 3 an 


a.out f i 


le (the execut- 


ab 1 e 


file). 









As oreviouslv statea the user, for efficiency reasons, 
should create and compile his programs on the "6" side of 
the laboratory facilities. If the user has followed this 
guideline he now has an executable program that will display 
some colors and text on the PA'-'TEK screen (the user should 
not be concerned with how this is done, but merely with the 
procedure), but the executable orogram is on the " B " side 
and the "A" side actually nosts the grannies aisolay oev- 
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ices. The user must then transport his executable proaram 
from the "B" side to the "A" siae. 



The transportation of information from the "B" to the 
" A " side may be accomplished by using the system functions 
11 put” and M get' 1 . In order for the user to transfer the 
a. out file created from the compilation of CT5.c he must: 

(1) be logged in on both sides simultaneously 

(2) from tho " B" side tvce 
out a. out c/r 

(the system w i 1 1 respond DOME when t n e action is 
c omo 1 e t e ) 

( 3 ) f r c m the M A " side tyoe 
get a. out c/r 

(the system will respond with DOME when finished) 
Now the a. out file created earlier resides on both sides of 
the laboratory's PDF 11/50 computers. The user is also 
logged in on both sides and snould logout of the "B” side in 
consideration of other users. The user may now execute nis 
program and see the RA.'^TEK response. Prior to execution the 
user should ensure that the G X - 1 0 0 A is Dowered-on according 
to the first three steos in the chapter titled OPERATING I U - 
STRUCT IOMS. For the user to now execute the program he must 
type : a. out c/r . Tne P A m TEE should resoono with a display 

of assorted colors and alphanumeric data on the screen ana 
the terminal should respond with the % prompt. 
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The user ^av also use I M P ( ) and E X P ( ) (see UNIX pro- 
grammers manual [ o 1 ) for t-ne transportation of information. 
These routines oroviae two way communication but have cer- 
tain restrictions that make them a second choice. 

The user, having followed the C T 5 . c examole to comple- 
tion, now has two copies of t h e same file. One file is on 
the "A" side and the other file is on the " 3 " side. This du- 
plication of coce is a waste o * soace and as such the user 
should remove one of the copies. This removal can oe accom- 
plished by using the system routine " r m " .(type rm a. out c/r) 

The user is now precared to move into the specifics of 
the R A M T E K sucoort oackaoe. for more detailed information on 
C, UNIX, and the use of system terminals, refer to the ao- 
oropri ate document in the laboratory. 
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IV 



PROGRAMMATIC control OF the RAMTEK 



A. Gpeni nq the Device 



There is one I iorarv sunroutine that MUST ice called in 



every program that applies 
be the first such subroutine 
ately named 11 ramte<" / ocens 
access to it. This will also 
fresh memory) of any prior 
follows : 



to the RAMTEK/ and it must also 
called. This routine/ aooropri - 
the aevice and estaol i snes user 
clear the screen (and the re* 
aisolav. The call may aopear as 



ramtekC); 

As mentioned nere/ this must be the first RAMTEK subroutine 
call in the user's prooram. This routine will return a 
value of negative one (-1) i * unable to ooen the device# 
otherwise it returns a zero value. Tne return of a neoative 
number to indicate an error conoi r i on is common practice in 
this system and its oneratina environment. The user should 
consult A poena i x b to find the orooer ciaanostic information 
for each routine in the software supoort packaoe. 
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B. Virtual Screen Di Tensions 



In oraer to develoo functional oroarams for acol i cat i on 
to the RAMTEK, the user must be aware of the conceot of the 
" virtual 1 ' screen# which means the user's view of the screen 
will differ from the real hardware configuration. The 
display screen may be thou art of as being made uc of 2 4 0 
horizontal lines# each consisting of 640 elements. (Each 
line/element comoi nation is called a " o i x e 1 " . ) In real i tv# 
this device has 512 raster lines. Due to certain interfacing 
restrictions it has been modified to allow only 480 of these 
lines to oe vis i ole. The other 32 lines exist off the bottom 
of the screen and are of no concern to the user except when 
the "scroll" routine is employed, (see Special Apol i cat i ors 
Routines"# Chac X V I ) . All other disnlav routines in the sup- 
port package mao the user's addresses onto the 480 visible 
lines. Since this G X - 1 0 0 A accesses these visible lines in 
pairs rather than individually# tne result is 240 address- 
able lines. Thus the initial view of the screen could be 
that of a 640 bv 240 orio with the coordinates (0#0) in tne 
upper left corner and the coordinates ( b 4 0 # 2 4 0 ) in the 1 o * e r 
right corner. This is NOT the view that is used when operat- 
ing through the R A M T E K support oackaoe. 

The software support routines have been designed to 
transform the screen into the more conventional " Cartesian" 
grid oattern that has its minimum values in the lower left 
corner and its maximum values in the ucoer right corner. 
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Thus the user views a virtual screen as described by an or- 



dinary Cartesian arid system. 

It should be notea here that the initializing "rarrtek" 
routine dimensions the virtual screen to 100 X 100/ with the 
lower left corner representing the point (0. 0/0.0) and the 
upper right corner (100.0,100.0). 

By utilizing the routine caller "screen" the user may 
dimension the virtual disclay screen to any desired size, as 
long as the coordinates conform to the conventional Pattern. 
The call is of tne form : 

screen(xmin/vmin/xmax/ymax)/ 

where the parameters are real numbers that represent the 
minimum and maximum ranaes for the conventional Cartesian 
coordinates. After dimensioning the screen to the desired 
size/ the user may relv uoon the software suooort package to 
convert any set of cocrainates t h at are valid for that grid 
system into the o r c o e r real screen location, (see "conve" 
and "convl " in Chapter XVI/ Special Applications Routines) 

C. Virtual Screen Accressi no 

The user has no* cefined the address space for the vir- 
tual screen/ and may choose the coint from which the display 
should begin. Tnis involves the location of the Current 
Operating Position ( C 0 D ) . The COP is initially located at 
the lower left corner of t u e screen. This is the case after 
every call to the "screen" routine. A new location for the 
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COP may be established bv using the "strtxy" routine and 
passing as carameters the virtual x,y coordinates of the 
desired starting point. This call should be of the form : 

strtxy(x/y); 

where x and y are real numbers. The COP is modified by most 
of the actual display routines, as explained in subseauent 
chapters of this manual. Therefore the user must confirm its 
location prior to attemotina to display another image. 

There are three modes of adcressinc tne P A ^ T E K screen : 
absolute, relative, and indexed. 

1. Absolute addressing is the normal or default mode. 
The starting ocint (COP) for a lisolay is selected by 
use of the "strtxy" routine. Tne ending COP defends on 
the current control mode (Chao VII - XIV), and the 
tyoe of disolay that is generated. 

2. Relative addressing is onlv acolicaole to the graph- 
ics control mooes. Its only use is throuch the routine 
called " d o i n t r " . The real numbers passed as parameters 
in "poi nt r" are summed with the x ana y values of the 
last COP to derive the next COP. This allows the user 
to generate such displays as a seauence of vectors 
drawn relative to each ether, without computing tne 
actual screen coordinates of all the end points. As an 
examol e, if the COP was located at (10.0,10.0) ana the 
user issued the command 

oo i n t r ( 5 . 0 , -5 . 0 ) ; 



the new COP would be located at 



(15.0,5.0). If the 



user was ooerat i nq in the Grach ic Vector mode, the 
above call •* o u 1 a have arawn a vector from virtual 
screen point (10. 0/10,0) to ooint (15.0,5.0). 

3 . Inaexed addressing is turned on and off by use of the 
"index” routine. A call of the form 

innex(i ,x,y); 

where i has the inteaer value 1, would initiate in- 
dexed addressing. All subspauent instructions * o u 1 0 be 
interpreted with resoect to the x ana y parameter 
values in that call. This address maocing is cone oy 
summing any subseauent screen address with these 
values to determine a new COP. For example, if the 
following subroutine calls were issued 

index(l,2.0,2.0); 

Strtxy(3. 0,3.0) ; 

the COP would be located at the virtual screen coorci - 
nates (5. 0,5.0). This addressing scheme can be em- 
ployee in any of the control m o c e s . Indexed addressing 
is terminated by issuing another index(i,x,y) call, 
with the oara meter i having a value of zero. In this 
case, the x anc y parameters are ignored. 

D. Control M caes and Fleas 

Programmatic control of the GX-10QA display device in- 
volves selecting one o * eiaht control modes. Each of these 
modes is affected cv certain control f 1 a q s . A separate 



chapter in this 



manual is devoted to each of the control 



modes, A description of the five control f 1 aas is presented 



here. 



IX - Indexed Addressing 



The effect of indexed addressing is explained above in 
Virtual Screen Aoaressinq, along with a discussion of its 
controlling routine called "index". 

BK - Reverse Background 



When set/ this causes a "reverse polarity" in the color 
selection process. It effectively reverses or inverts the 
current color table. The areas of tne screen that were being 
shown in color entry 0 (normal background color) will be re- 
verted to Color entry 15/ and vice-versa. (see Chao VI/ 
Color Displays) This flag is turnea on and off bv tne 
"bkrno" routine. The flag would be turned ON if the parame- 
ter o was given the value 1 in the following call : 

bkrnd(t) ; 

If o was given a zero value the flag would oe turned OFF. 

A w - Additive ft r i t e 



i/v h e n set/ the generated imaae is combined with the i m a o e 
already being projected at a particular location. This may 
be used to combine characters into special characters/ 
create overlay type displays/ or display so m e character 
close to another i m a o e without oestrcying a portion of that 
image with the seven by twelve pixel matrix usea in display- 
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Alphanumeric 



i nq alphanumeric characters, (see Chao. VII, 

Mode) The control of this f 1 aq is accomplished by the " w r i - 
ton" routine. As before, if tne single parameter is a 1 the 
flag is turned on? if it is 0 the flaa is turned off. The 
call should aooear as follows : 

writon(w); 

where w represents either 0 or 1. (See Appendix B for error 
d i agno s tics) 

0 W - Double Width 



S'lhen 


set/ the 


i mace be i 


no displayed is 


doubled 


i n 


width 


from its 


norma) 


size; i 


e , where 


one 


element 


was 


being 


" p a i n t e a " 


two consecutive 


el events 


on 


that 1 


i n e 


are 


d i sol a y e d 


in the 


se ) ec t ea 


color. The 


des i 


red character 


size 



(normal or double width) mav be selected by usinq the "size" 
procedure as follows : 

s i z e ( s ) ; 

where s is either t or 2 , representing normal or double wide 
respectively. (See appendix b for error diagnostics) 

FP - Fixed Point 

When set, this causes the (next) established COP to be- 
come the common start i nq ooint for all subseauent end points 
issued in Graphic vector ana olot generation* (see the 
Chapters on araphics moaes) T h ^ fixed ooint flaa is turned 
on and off by the routine named " fixof". This single- 
parameter function accepts either a zero (to turn off the 



flag) or a one (to turn on the flag) 
the form : 



The call would be of 



fixot(f)? 

where f is either 0 or 1 • (See Aooendix fl for 

tics) 

The association of these flaas with tne d 
is shown below in a listina that indicates 
effective in each mode. Note number ass 

m o d e ^ as tnese numbers ar° used in implement 
of operation on tne R A V T E K . 



cS 



error d j agnos- 

i f ferent mooes 
which flags are 
iqnea to each 
i ng these modes 



Mode 



Control Flags 



No • 


Name 




I X 


SK 


AW 


DM 


FP 


0 


Alphanumeric 




YES 


YES 


YES 


YES 


NO 


1 


T rans ve rse Data 




YES 


YES 


YES 


YES 


NO 


2 


Ra s t e r 


Data 




YES 


YES 


YES 


YES 


NO 


3 


Comp! ex 


Data 




YES 


YES 


NO 


YES 


MO 


a 


Graphic 


Vector 




YES 


YES 


NO 


NO 


YES 


5 


G r a d h i c 


Plot 




YES 


YES 


MO 


NO 


YES 


6 


Graoh i c 


C a r t e s i 


an 


YES 


YES 


NO 


NO 


NO 


7 


Graphic 


Element 




YES 


YES 


NO 


NO 


NO 




The control modes 


are selected 


DV 


use o Y 


the "setmode" 


routine. This 


routine 


requires two 


parameters/ 


the f i 


rst be - 


i ng 


t he number 


0 f the 


desired mode 


a s 


indicated 


above 


. The 



second parameter must be either 0 or 1. If zero is oassea 
all control Maos are turned off. If one is oassea the con- 
trol flags are left in the state they were in prior to this 
call. The call is of the form : 

set^odefa/b) ; 

where a is an inteaer value 0 - 7 and b is either 0 or l . 
(See Appendix R for error diagnostics) 
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V 



VECTOR GENERAL DATA TABLET INTERFACE 



The Vector General data tablet is an electronic device 
which allows the user to sample the coordinates of its 
tablet-like surface (aooro* 17” by 17" J. Ihe tablet is lo- 
cated in the Laboratory and is nested dv the " A" side 
PDP-11/50 computer. 

This taolet is interfaced to the R A M T E K software sud- 
port routines to orevide the us^r with a valuable interac- 
tive tool. To effectively utilize the data tablet/ the user 
must become familiar with it's operation,. The following 
steps will facilitate the familiarization orocess : 

(1) Locate the data taolet (for assistance see the 
s t a f f ) . 

(2) Note the 0^ -OFF switch located on the box con- 
nected to the tablet surface. To use tne tablet 
the switch must oe ON; when not in use the Switch 
should be OFF. 

(3) Locate the stylus (a pen-like device connected 
to the controller oy a wire). On the stylus there 
is a o 1 unger tio that may be Depressed. The 
deoression of this tio is sionificart in certain 
applications. 

(4) Also notice/ on the tablet eaae/ that there 
are two Hants. One light indicates that tne 



stylus is near the tablet surface and the other 



indicates that the plunger is depressed. 

(5) Turn on the tablet and witness the functions 
of the stylus and the reactions of the lights. 



The data tablet interface allows the user to interac- 
tively control the execution seauence of his crogran. To 
effectively utilize this tool/ the user snould be aware of 
what the software suoport routines/ desianed for the tablet/ 
can do for him. There are seven software supcort routines of 
interest to tne user. An interactive tutorial program is 
provided for the user’s convenience. This croqrarr exercises 
each of the software suoport routines to give the user a 
feel for what thev can do. To use the tutorial the user 
types(at one of the " A " side terminals) : 

LOGIM; c s 2 0 0 0 c/r 
PASSWORD: student c/r 
cd ramtek c/r 
vatab.x c/r 

This seauence of stecs is for the user who is not al- 
ready looaed in to U^'I*. If alreaav logged in/ the user need 
only change to the " ramtek M directory, then execute the tu- 
torial program. This would be accomolished by typing : 
cd / u s r / c s2 0 0 0 / r am t e k c/r 
vgtao.x c/r 



In either case the result will be that the tutorial 
program will be activated. It exercises eacn of the f unc- 



tional routines in the sunoort oackaae. Users are encouraged 
to "walk throuoh" this session prior to attempting to enaaae 
the seoarate tablet routines. At the comoletion of the ses- 
sion the UNIX crorrot ( % ) will apoear on the terminal. 

For reference our coses and for tne user who only needs 
to be refreshed on the functions of the tablet support 
routines a brief description of ^ a c h is Provided. The fol- 
lowing is a synoosi s of the routines included in the oackaae 



(1) tabinir() : Ocens the tablet and sets the max- 
imum number of switches to 25. 

(2) tabaim(txmax/txmin/tvmax/tymin) : Allows the 
user to define his own view of the tablet by stat- 
ing the maximum and minimum values of his co- 
ordinate system. 

(3) getxy(n) : Returns tne x and y co-ordinates of 
a point on the tablet/ as defined by the location 
of the stylus. Tne argument "n" allows the user to 
select whether or not the t id need be depressed 
( n = 1 oen must be depressed/ n = 0 pen not 
depressed) . 

(^l)si xoak ( ) : Defines and allows selection from a 
standard set of six loaical switches on the 
tablet. (see temolate 1 in Lao) 

(5)builasw(sw/xhi/xlo/yhi/ylo) : Allows the user 
to build his own loaical switch at a location de- 



fined by the users input and assigns tne users 



switch number (sw) to it. 



(o)aetsw( ) : Returns the numoer of the valid logi- 
cal switch in which the stylus has been deoressed 
or a -1 if invalid. 

(7) tabsw(ns) : Allows the user to define logical 
switches via the tablet itself by oickinq the low 
and high ooints of each switch with the stylus. 
The number of switches aesired is indicated by the 
oara meter "ns". 

For more specific information on these support routines 
see Append i x B . 
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VI, COLOR DISPLAYS 



The RAMTEK hardware i t,o1 events color oy combining red; 
blue ana green in varying intensities to produce the Cesired 
color* The vary i na intensitities are stored in the video 
1 ook-uo taole ( V L T ) for access by the hardware. The G X - 1 0 0 A 
can generate lo levels of intensity for each of the three 
basic colors^ which results in 4 0 ° 6 possible different com- 
binations. The o o s s i b i 1 i t y of 4 0 Q 6 different colors does 
not mean that the user has all available at once! The 
RAMTEK software allows for 13 color tables of 16 color en- 
tries each. This ^eans that the user nas access to 2 33 
colors. The G X - 1 0 0 A can access only one table/ with 16 dis- 
tinct colors/ at any given time. 

For clarity the hardware video loox-uc table will oe 
referred to as the color look-uo taole. The hardware- 
accessiole color loo<-uo table can store sixteen (lo) 
seoarate colors. T r j s constraint is one that the user should 
be aware of/ but not concerned with/ as the software support 
routines allow the user to overcome this restriction auite 
easily/ through manipulation of the tables. 

The software that orovi des the color suooort for the 
RAMTEK allows the user to : 

Utilize oreaefined colors. 
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Define his own colors. 

Select color sets. 

Select soeci fie colors within a set. 

Interactively modify colors. 

Save color tables. 

Restore color tables. 

lext and/or grannies m a v be disolayed in anv oefined 
color. The software suooort ad lows the user to define vir- 
tually any color that he desires. 

A. BASIC USER GUIDELINES 

The R A M T E K software oreloaos a set of color tables for . 
the user. These tables orovide for the color needs of most 
beginning to intermediate users. 

The R A M T E K support software orovides the user with a set 
of tools that allow h i rn to select the color to be used for 
disolav. The user must cause the aoorooriate color 1 ook-uo 
table to be initialized and then he may select from colors 
within it. The initialization of a oarticular color table 
is accomplished by invoking a supoort function "col ort (n) M . 
When "colort (n) " is called the following actions take place: 

1. Color table n is loaded. 

2. All disolav images on the screen are refreshed 

with the new color set. 

3. The oackqround color of the screen is set to 

entry zero of the new table. 
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Once the user has loaded a particular color table. 



has sixteen colors available for disolay. To then select a 
color from tne tael e to be used for display, the system sup- 
port function " color(n)" is utilized. All images displayed 
subsequently will be cisolaved in color M n " of the current 
color table. 

Of the eighteen tables established by the so" ft ware, nine 
are filled with predefined colors ana nine are blank. Four 
of these taoles are protected from user modification (0-3). 
These protected tables ^ a y be utilized out not modified. The 
nine predefined tables provide a sufficiently large color 
selection for most users; however, there are a total of 
eighteen (18) color tables should the user require more 
flexibility. The nine blank tables must be defined or filled 
by the user if he desires to use them (see the explanation 
in Advanced Color ;V ethoas). The colons present in the nine 
predefined color taoles sre listed oelow! 

COLOR TABLE COLOR 



0 


shades 


o f 


grey 


1 


shades 


o f 


blue 


2 


shades 


o f 


green 


3 


shades 


o f 


red 


a 


mi x e d 






5 


mi x e d 






6 


mixed 






7 


mi x e d 






6 


shades 


o f 


y e 1 low 



The R A M T E K user software allows the viewing of any color 



table in the system. For the user to look at a particular 
color table he need only issue the aoprooriate system call. 
Two different types of display are available, an expanded 
and a brief displav. The brief disolay may be selected by 
the system function ” dsoyctbl(n)'*; the expanded by 
"disoCn)". 

The brief display causes color table ” n " to be displayed 
as a column of boxes in the in dividual colors of color table 
"n". The expanded disci av aives the user not only a column 
of boxes, out lines and alohanumerics in each color, as well 
as the octal code that achieves that color combination. 

The best way for the user to oecome familiar with the 
concepts and suooort functions introduced is by using them. 
Three executable pro a rams have been provided for the users 
convenience. 

1. PROGRAM 1 

This program is aesianeo to demonstrate the brief 
color table disolay, loading of a color table, selecting a 
particular color entry from a color table, ana the result of 
a particular color selection. The program will first 
display color table seven (7) in the brief format, then de- 
lay for six (o) seconds and display a box in color four of 
color table seven. The user may tyoe the program in himself 
or use the c s 2 0 0 0 file where it exists in ooth the source 
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form and an executable form 



a. To use the c s 2 0 0 0 file type : 

LOGIN: c s 2 0 0 0 c/r 
PASSWORD: student c/r 

cd ram t ek c/r 

b. To list the o^ogram: 

list -c o 1 . c c/r 

c. To execute the Program: 

p 1 . x c/r 

a . For the user who aesires to input/ compile/ and exe- 
cute the proaram himself a listing of the source code 
is provided, 
ma i n ( ) 

{ramtekC); //initialize R A M T E K 
eraseO) //erase the screen 
dspyctbl(7); //disolav color table 7 
colort (7) ; //select color table 7 
color(d); //select entry 4 
sleeo(o); //aelay o seconds 
block(50. 0,50. 0,7^. 0,25.0); //draw block 



> 

fhe routine "block" will be exolained in a later 
chapter; it should not concern the user at this stace. 



2. PROGRAM 2 



This example is desioned to introduce the user to 
the expanded format for displaying a color table and the e f - 



feet on the screen i m a a e of 1 o a a i n a a new color table. Par- 
ticularly the example oisnlays color table six (6) in the 
expanded format* delays six (6) seconds ana then loads color 
table five (5). The user should note that when the new color 
table is loaded it is effectively displayed* but the text 
still indicates that it is color table six ( b ) . This 
highlights the fact that all of the information displayed 
changes color out the information itself remains unchanged. 

a. To use c s20 00 : 

LOGIN: c s2 0 0 0 c/r 

PA3S/*0PD: student c/r 

cd ramtek c/r 

b. To list the program: 

list -c p2 . c 

c. To execute the pronrau: 

o2 . x c/r 

d. To input the crooram the following listing is pro- 
vided : 

main!) 

i 



ramtek'O ! 


//initialize 




erase!) * 


//ere se 


sc r een 




c o 1 o r t ( o ) 


? //load 


Color 


table 


o i s o ( b ) ** 


/ /cii solav color 


t ao 1 e b 


s 1 eeo ( b ) ; 


//del ay 


for 6 


seconds 


c o 1 o r t ( 7 ) 


r //load 


new color table 



> 
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3 



PROGRAM 3 



This example is desioned to emphasize the effect of 
the display color selection. Color table s e v e r ( 7 ) will oe 
loaded then a box displayed in color 3 of that table. A 
short delay will occur, then anotner box will be displayed 
in color four (4) of that table. The dsoyctbl option is used 
to allow the user to verify the results. 

a. To use c s 2 0 0 0 : 

LOGIN: c s 2 0 0 0 c/r 

PASSWORD: student c/r 
ca r am t e k c/r 

b. To list the orooram: 

list -c o3.c c/r 

c. To execute the crogram: 

o 3 . x c/r 

d. The Program listing follows: 

main!) 

{ r a m t e k ( ) ; //initialize rantek 
col ort (7) ; //select color taole 7 
dscyctol(7); //display color table 7 
color(3); //select color 3 
/ * d r a w box in color 3 * / 
blcck(5 0.0, 75. 0,95. 0,5.0) ; 
sleep(6); //delay 6 sec 
color (^) ; //select color 4 

block(65.0,o0. 0,80. 0,20.0); //draw box color 4 

} 
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The user should no* he capable of writing programs 
that utilize basic color manipulation techniques. There are 
more complex and sooh i st i cated options that are covered in 
the next section. 

B. ADVANCED COLOR METHODS 

The basics for color manipulation recuire little effort 
on the part of the user. Since the more advanced user may 
need to solve a more complex problem/ the R A M T E K software 
has been designed to assist the us^r and simplify these 
sometimes complicated tasks. 

The hiaher level user-oriented suoocrt routines are pri- 
marily to allow the user to modify existing color tables/ 
build new color tables/ save a qrouo of color tables/ ana 
restore to an active status old color tables. 

1 . MODIFYING COLOR T ARLES 

The modification of the IF color tables may be ac- 
complished by utilizina the data tablet or the R A M T E K key- 
board. Each of these techniaues will be discussed so that 
the user may intelligently select the appropriate one. 

a. DATA TABLET METHODS 

The system software that supports data tablet 
color manipulation is compact ana fast? this will be an ad- 
vantage to the user who requires on-line color table maniou- 
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1 a t i on 



In order to execute this suoport package the user 



issues a call of the for^ : t abccl or ( ) ? . The system will 
then prompt for the requires inputs to alter and/or ouild 
color tables. 



The user-oriented routine "taDColorO” offers 
one of two options : building an entire table or changing an 
existing table. The tablet is viewed in this application as 
per template 2 in the Lab . Once in execution the program is 
tutorial in nature and will pro mot the user for required in- 
puts. A sample session is provided to familiarize the user 
with color manipulation via the ciata tablet. 

(1) PROGRAM a 

This exercise is aesianed tc familiarize 
the user with the techniques used by the data tablet color 
manipulation function. 

( 1 ) T o use t h cs200 0 * i 1 e tyce : 

LOGIN: CS2000 c/r 
PASSWORD: student 
co r a m t e < c/r 

(2)To list the source code: 
list -c o^.c c/r 
(i)To execute the ore o ram: 
o u . x c/r 

(4)For the user who wishes to inout the source code 
himself a listing is provided. This program initial- 
izes the RAMJET* erases the screen and then calls into 
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action the data tablet color manioulation package 



ti a i n ( ) 

{ramtek(); //initialize 
tabinitC)/ //initialize tablet 
eraseO ? //erase screen 

tabcolorC); //call V . G . tablet routine 
erased ; 

> 

b. KEYBOARD METHODS 

r ri e ouroose of this interactive program is tc 
allow the user to see and modifv the color look-uo tables 
while seateo at the P A w T E K kevboaro . This extensive 
software oackaae is very large and should not oe used in- 
discriminately. Tt is hiahly recommended that it be used 
only to build a set of color tables, tnen save these tables 
to be loaded into the users oroauct i on program at a later 
time (see saving color tables). 



For a complete explanation of this oct ion see 
the description of inter ( ) in aocendix B. If the user is 
interested in utilizing this ootion he should execute tne 
following program tc get an appreciation for it's c a p a b i 1 i - 
ties. 



Cl) PROGRAM 5 



This example program initializes the R A M T E K 
and calls the interactive color manipulation routine. 
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(a) To use tne c s 2 0 0 0 file tyoe : 

LOGIN: c s 2 0 0 0 c/r 
PASSWORD: student c/r 

cd ra.nte^ c/r 

(b) To list the Program: 

list - c d S . c c/r 

(c) To execute the program: 

d5 . x c/r 

(d) Program listing: 

main() 

{ramtekO; //initial 
eraset); //erase the 
interO; //call colo 
> 

The utilization 

will result in the user o r o g r a m being b 9 <18 cytes larger. The 
size of ore grams oeing a consideration in software desion 
implies that inter!) should be used selectively. There are 
specific acoli cations that reauire it's use ana it will per- 
form well in these applications. 

c. manual COLOR loading 

The system orovides for the user the capability 
to programmatically load a particular color table as an ar- 
ray of entries. This process is more cumbersome ana less 
flexible then the other two color manipulation techniques. 
The programmatic loading of a color table by t h e user forces 



i z e 

sc r e e n 

r manio. routine 

of inter!) vice tabcolor!) 
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him to preselect colors and manually provide the mechanism 



for loading , out in small uncomplicated a polications af- 
fords the user a feasible solution to h j s i m m e o i a t e problem. 

The orogrammatic loading of a color table is a 
two steo process. The first steo in the process is to con- 
struct an array in his program that defines the selected 
color intensities. This definition of colors is accomplished 
by first declaring an array of 16 elements, since this is 
the number of elements in a color t a o 1 e . The array must 
then be given the aocropriate color intensities by a system 
software routine call ^ o triolet) (see Appendix 8, triolet), 
for specifics). The tricle routine returns a coded value 
that reoresents the appropriate color mix. Once the array 
has the aoorooriate ceded value it* is then programmatically 
loaded into the master array of color tables by calling the 
system routine "clrtbl (t,a)" (see clrtbl. Appendix B), where 
M t" is the numper of the color table to be replaced and 11 a M 
is the name of the color taole holding the coaec values. 

This orocedure may seem complicated and is prob- 
ab 1 y better illustrated by an examole. The user is en- 
couraged to execute the example program to experience the 
process . 

(1) PROGRAM b 

This program ta'<es a certain predefined set 
of color mixes and builds color taole 9. Once tne color 
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table has been bui I t » it is then displayed for the 
view. In addition to displaying the color table/ 
intersecting lines are drawn tnat intersect at 
screen co-ordinates (5. 0/5.0). The lines are drawn 
4 of color table 9/ the one just built. 

(a) To use the c s 2 0 0 0 file tyoe: 

LOGIN: c s 2 0 0 0 c/r 
PASSmORC: student c/r 
cd ranted c/r 

(b) To list the program: 

list -C ofe.c c/r 

(. c ) T o execute the proaram: 
pb . x c/r 

(d) Program listing: 

int a 1 1 6 J / //declare array 
main!) 

I r a m t e k ( ) ; / / initialize ramtek 

/* set color intensities into array */ 
a[01=trip1e(15/15/15); //white 
atll=tricle(l5/0,0); 
a (21 stridefO, 15,0) ; 
a(3J=tricle(0/0/ 15): 
a[9]=tric1e(3/l J /2): 
aC51=triple(8/15/0); 
a[6]=tricle(8,0/0); 
a(7]=triple(0,8,0); 
a(8)=tricle(0/0/8); 
al9]=triole(8/8/0); 
a 110) =trio1e(0,8,8) ; 
arill=tricle( a /0,8); 
atl2]=tPiDle(10/10,10); 
a[13]=trioleC9,9, 1); 
a (l'H - tricl e ( 5 , 0 , 5 ) ; 
atl5)=triolef a /l/15); 
c1rtbl(9,a)/ //load master array 
asoyctbl (9); //display color table 9 
c o 1 o r t ( 9 ) ; color(9); //select color 
screen(0. 0,0.0/ 10.0, 10.0); //dimension 
a x i s ( 5 . 0 , 5 . 0 ) : //draw axis 

> 



user to 
a set of 
v i r t ua 1 
in color 



sc reen 
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The user/ havina now executed the sugaested 
sample oroarams/ should have a good appreciation for how to 
create ana manipulate color tables. If more in-deb th infor- 
mation is required, the user is encouraged to research 
References 1 and 3 for the specific hardware and suonort 
design. 



2. SAVING COLOR TABLES 

As mentioned earlier, the system color tables are 
initialized each time a user begins a session. These colors 
may oe altered b v the met nods described aoove. The ability 
to save the current state of all color tables for use at a 
later time not only enhances the users caoabilities but is 
an absolute must for production programs that require cer- 
tain color sets. The user will certainly eoorec i ate the 
oroblem if he considers the case where he has defined a 
large number of specific color sets for distinct applica- 
tions using "tabcol or( ) " and/or ”inter()% and has no way to 
save them, without the color savina option, in order for the 
user to continue to use a specific set of defined colors in 
repeated runs of the same program, he must reconstruct them 
each time. 



In utilizing the save color option t n e user must be 
aware of two routines: 
s a v c 1 r ( ) ; 

r e s c 1 r ( ) ; 

The routine "savcl rO” saves the entire color arrav in a 
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The routine 



r esc 1 r ( ) 



file called ’’savcol " . 
file "saved " into the active 
user may reinstate a soecific 



r es t o res 
master color array so that 
set of color tables. 



Ph 



the 

the 



VII, ALPHANUMERIC MODE 



A. INTRODUCTION 

This mode is used for aisolaving alphanumeric (ASCII) 
characters on the P A M I E K screen. The basis of this mode is 
the transformation of the individual ASCII characters into a 
dot matrix by means of a character font. The font aefines 
this matrix to be five screen elements by seven screen lines 
in dimension. This character matrix is actually di sol ayea 
within a seven element by twelve line matrix/ to provide 
separation of characters. This is illustrated in Apcendix B 
of the RAMTEK G X - i 0 0 Programming Manual t l ] . 

The ASCII characters are oisolayed start i no at the 
Current Operating Position (COP) from left to right on the 
same line. If more tnan 91 characters are written cn one 
line# t h e y will "wrap around" and over write the Peg inning 
characters on that same line. (If the optional "double- 
width" size cnaracters are used# the maximum number per line 
is 45 . ) 



The applicable aots (pixels) in the character matrix (as 
defined by the character font) will appear in the current 
selected color/ while the remainder of the ^atrix will be 



filled in 



witn the current bac^arouna color 



B. BASIC USER GUIDELINES 

As mentioned earlier in this manual# the software sue- 
port packaae for the RAMTEK is contained within the UNIX 
file system# in the form of a library of suoroutines written 
in the * C 1 programming lanauaqe. These routines are accessed 
(via any of the terminals on the "A" system) by compiling a 
user-createa 'C' program containing references to functions 
that reside in that library. The special snell conmana for 
compiling a program that calls routines from the RAMTEK li- 
brary is called " ramtek" # and neeas only be passed tne name 
of the file to be compiled. 

Such a command woulo be cf the form : 

ramtek filename. c 

(note that the file must be of tyoe " . c " ) 

The first graphics routine that must be cal 1 eo from 
within the user's program is# in every case# the one that is 
also named "ramtek". (This should not oe confused with the 
shell command above) This routine ooers the device# erases 
the screen# and establishes user access to it. The call 
should appear as follows : 

r a m t e k ( ) 1 

To place the RAMTEK device in the Alphanumeric ^ode# the 
user may utilize tne "setnode" routine# with a call of the 
form : 

setmooe(Q#0); 

(Note : the Alphanumeric mode has been defined to be mode 
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"0"; trie second parameter of M 0 " turns off any previously- 
selected control flags? a "l" in this position would 
preserve these flaas.) 

Although some aisclav routines will automatically set 
the. prooer mooe, it is good practice to include this "set- 
mode'* call in user Programs. 

The user is now ready to select the area on the screen 
in which he cesi res alphanumeric data to be disolayed. A 
quick review of the initializing " ra^tek( ) " routine would 
reveal that the virtual screen has been dimensioned to 100 X 
100, ana the Current Operating Position (COP) is located in 
the lower left corner (coordinates 0,0). If these dimensions 
are not favorable, the user may select his own with a call 
to the "screen” routine of the form : 



screen(xmin,ymin,xmax,ymax) ; 



where the 


oarsTeters are real 


numoe r s 


• 






In any 


case/ before a 


call to 


one of the 


display 


routines. 


the user should 


conf i rn 


the location of 


the 


COP 


(the point 


at which tre bisol 


a v will 


oeqin). The COP 


may 


be 



re-established by a call to 

Strtxy (x,y) ; 

where x and y are real numbers for the desired virtual 
screen coordinates. 

For the simple application of displaying a single char- 
acter on the screen, the procedure called " I t t r ( c h , s i z e ) " is 
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used. The call is of the form : 



1 1 1 r ( ' x ' , si ze) ; 

where the character a e s i r e a to be output is enclosed in sin- 
ale quotes or its ASCII coae is given without auotes. The 
size is passed as either 1 (normal size) or 2 (double 
width). All control bits or flags remain as previously set. 
The character is aisolayed at the existing COP. No line feed 
occurs^ but the x-value is incremented cv 7 real screen ele- 
ments as a result of the cutout. (The COP moves to the right 
7 pixels.) 

The most straiaht-forward aooroach to displaying a set 
of ASCII characters/ such as a bloc< of text / is with a call 
to the routine " t e x t o M / which requires 5 parameters/ in ord- 
er/ as follows : 

1. The address of an array of pointers to the text? The 
cointer array should have been declared as pointers to 
an array of va r i ao 1 e- 1 ena t h character strings. The ac- 
tual array of character strings should be initialized 
following the array declaration p y enclosing eacn 
string in douole auotes and separating them by commas. 
The last element should be a zero / without auotes. 
(see example below) 

2 • The number of the desired color table (an integer 
value I 4 - 17) 

3 . The numoer of the desired entry from that color table 
(integer value : 1 - 15) 
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4 . An i nteaer value (1 or 2) to denote desired character 



size- If this oarameter has value 1 the characters 
are displayed in normal size? if it has value 2 t the 
characters are cisolaveri in d o u o 1 e width size. 

5 . An integer value (0 or 1) to oisable/enable the addi- 
tive write cacaoilitv. If this parameter has value 1/ 



the corresponding 


te^t 


will 


be 


written " 


on 


too 


of" 


( i e / in addition 


to - - 


no t 


i n 


rep 1 ac emen t 


o f ) 


the 


ex- 


i sting screen image. If 


the 


v a 1 


c 

a> 

(/> 

o 


the 


oesi 


red 



text will replace the contents of the refresh memory 
that exists at t K e soecified locations. 

1. PROGRAM 7 

The execution of this orcqram will oisolay the de- 
clared block of text in double-width cnaracter size/ start- 
ing at the virtual screen coordinates (2 5 . 0,75.0). The char- 
acters will be written in the color specified by color entry 
5 of color taole 7 , and will reolace any data previously 
written tnere. 

This orooram would normally be comoiled using the 
1 C * compiler in conjunction with the system library of R A » v > - 
TEK subroutines/ via the followinq command : " r a m t e < 

filename.c M / where filename is the name of the user file 
containing the program. However/ this example is available 
in executable form in the " c s 2 0 0 0 - r a m t e '< M directory on the 
"A" system, (see Chanter II/ Operating Instructions) 
a. To use the c s 2 0 0 0 directory : 



LOGIN: c s 2 0 0 0 c/r 



PASSWORD: stuoent c/r 
cd ramtek c/r 
b. To list t^e proqram : 
list - c d7.c c/r 
c . To execute the d r o g r a m : 
p7 . x c/r 

d • T h e I i st i na follows : 



char * t x t 1 [ 1 


/* decl 


{ " vv hat 


you see H / 


/ * oo 


" i s 


what you get "/ 


it 

It 


when you 


call . . 


M 




TE < T 0 


0 






} ; . 






i n t c t ao 1 


7; 


/ * 


i n t col 1 


5; 


/* 


i n t s z l 


2; 


/ * 


i n t wol 


o ; 


/* 


ma i n ( ) 






{ r am t e k ( )? 




strtxyC 25. 0/75.0) 


r 


texto ( t < t 1 »c t abl » 


col 1 / s z 



are and initialize the */ 
inter array ana text */ 



color table 7 . * / 
color entry 5 * / 
double width characters */ 
no wr i te - over * / 

/ * open the device * / 

/ * set starting point * / 
Uwoi); 



} 



C. ADVANCED ^EIHOHS 

After a review of "texto" in Appendix 3, the user should 



real i ze 


that i 


ts advantages lie in 


s i m d 1 i c i t y 


and general i - 


t y . In 


o r oe r 


to perform more 


comcl icated 


al ohanumeri c 


display 


tasks/ 


the user may wish 


t o Droceeo 


to a mere de- 


t a i led 


level o f 


operat ions. 







ly 



Further analysis of 
makes a series of 



11 texto " woula reveal 
ca 1 1 s t c 1 ewer- 1 eve 1 



that it actual- 
rout i nes . These 
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routines may/ of course/ be employed individually. 

As before/ the first step in displaying characters is to 
insure that the system is in the Alphanumeric mocse. This is 
accomplished by calling the routine 

set mode ( a / b ) ; 

passina a zero value to parameter a. Parameter h must re- 
ceive either a 0 tc turn off all control flags/ or a 1 to 
leave control fleas as presently set. 



Again# if the user wishes to change the dimensions cf 
the virtual screen/ he may call the procedure 

screen(xmin/ymin/xmax/ymax); 

and pass the minimum ana maximum values cf the cesi red coor- 
dinate system. This procedure leaves the COP at the lower 
left corner of the screen. 



In oraer to select a aesired wording color table/ the 
user may call 



colort (t); 

passina the number of the table to the parameter t. Then the 
appropriate display color entry is selected by a call to 

color(e); 

where e is the entry number from tne selected table. 



To estaolisn a new COP for a particular ai spl ay / tne 
proceau re 



S t r t x y ( x / y ) ; 

is utilized with the starting X and Y coordinates (as shown 
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before) beina passed as real oarareters 



The size of the characters displayed may be ordered by a 
call to 

s i z e C s ) ; 

with s beino either 1 or 2 . If s is passed a value of 1/ 
the characters will be displayed in normal size? if a value 
of 2 is passed^ they will be displayed in double width size. 

The selection (or deselection) of the 'additive write* 
feature (ie/ the intention to 'add to* rather than replace 
the present screen i^aqe) is relayed to the system by a call 
t o 

w r i ton(w] ) 

with w receiving a 1 if write-over is desired or a 0 if not. 

The actual next-level display routine that is called 
upon by "texto" is " s t r ou t ( s ) " , *h e re s is a pointer to a 
single strina of less than 100 characters, For example/ if 
the user had the following declaration in his orogram : 
char st r i nc 1 1 {"This is a String. 1 ’ } ; 

then a call of the form 

st rout (strina); 

would display that sentence on the screen. It should be not- 
ed here that after a call to "strout”/ an automatic line 
feed/carriage return is performed/ leaving the COP on the 
next available line and at the same element position as the 
prev i ous COP . 
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To carry this discussion one step lower in the struc- 
ture^ we Point out that "st rout M actually counts the number 
of bytes in the character string and passes this number* 
along with the aadress of the string, to the routine 
M data(name, length) " . This routine is also available to the 
user if he is certain of the number of bytes in his charac- 
ter string and ooes not attempt to pass a string that is too 
long. As an example, with th* same "cnar string" declaration 
as above, the user could write 

dataCsfrino, 17) ; 

to accomplish the same task as M st rout (string);" . This 
routine also leaves the CUP on the next line and same ele- 
ment as the previous COP. 

After some error check i no and sett i nq control pits, "da- 
ta" goes one step lower by making a system call to the 
"dump" routine, which transmits the raw data (according to 
the byte count) to the R A M T E K instruction buffer for in- 
terpretation and display. 

By similar inspection, we find that "size" actually 
utilizes a lower-level routine called "dblwio" to set the 
appropriate control bits ana "dump" this data to the PAMTEK 
bu f f e r . 

The "dump" routine exists at about the lowest level of 
the user interface. To directly utilize this routine, tie 
user is aavised to aein a oreater familiarity with the "PAM- 
TEK G X - l 0 0 P r o g r a m m i n g Manual" [11. 
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PROGRAM 6 



This s a m c 1 e program will demonstrate the use of the 
alphanumeric cisolay routines mentioned above. It is avail- 
able for viewing in the M c s 2 0 0 0 - ramtek" directory. Its 
execution will result in the declared string of alphanumeric 
characters beina displayed/ in tan Hem, at three successive 
locations on the screen, and in three different colors. Note 



that the second a i sol ay call in each instance is not oreced- 



ed 


by 


a cal) 


t o 


"strtxy". 


This 


demonst rates 


tne location of 


the 


COP 


after 


c a 1 


lino e i t h e 


r o f 


these display 


routines. 




a . 


To use 


the 


c s 2 0 0 0 d i 


rectory : 








LOGIN : 


C 3 


2000 c / r 









P A S S b 0 P 0 : stucent c / r 
ca ramtek c / r 

b. To list tne program : 

list -c ob.c c / r 

c. To execute the orocram : 

08 . x c / r 

d. The listing follows : 



char string [] { " This is a string." } ; 

//string declaration 

m a i n ( ) 

i ramtek ( ) ) / / o o e n the nevice 

screen(0.0,U.0/ 10.0/ 10.0); //dimension screen 
colort (7) ; // select color table 7 

color(l); // select color 1 
setmode(0/0); // select alphanumeric moae 
s i z e ( 2 ) ; // select double- width size 

strtxy(0.5/P.O); //set starting ooint (COP) 
strout (string); // display tne string 

da t a ( s t r i ng / l 7 ) ; // display same string 

s 1 e e p ( 2 ) ; // cause 2 seconds 

color(U); // cnanae color 
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strtxy(3.0/b.0)? / / chanae COP 

strout(string); / / repeat oi sol av 
nataCstrinqr 17); // " 11 

s 1 eep ( 2 ) ; 

c o I o r ( 7 ) ; // change color again 

s t r t x y ( 5 . 5 / 3 . 0 ) ; // chanae COP again 

data(strinq/17); // reoeat display 
strout (strinq) ; // repeat display 



} 

This same display could be achieved by the following 
more concise program/ better utilizing some of the features 
of the ' C f programming language* It also exists in execut- 
able form in the " c s 2 0 0 0 - r a m t e '< " directory discussed in 
Chapter 1 1 . 

2. PROGRAM Q 



Note the initialization of variables in declaration state- 
ments/ ana the use of assignment statement’ s and expressions 
as parameters in the procedure calls for "color" and 
"strtxy”. Once again : 

a. To use the cs2000 directory : 

LOGIN: c s2000 c /r 
PASSWORD: stucent c/r 

cd r am t e * c/r 
P. To list the crcpram : 
list -c p9.c c/r 
c. To execute the program : 
d9.x c/r 

• The listing follows : 



char string [ ] {"This 
float stx -2.0; // 

float sty 9.0; // 

fnainO 



is a strina."}; 

initialize starting X value 

It It y M 
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a 



(inf i ; 
ram t e k ( ) ; 

screen(0. 0,0.0, 10.0, 10.0); 
setmode(0,0); s i z e ( 2 ) ; 
c o ! o r t ( 7 ) ; 

for ( i = 0 ; i <= b;i - i+3) 

{color(ifl); 

strtxy((stx = s t x f 2 . 5 ) , ( s t v - i)); 

St rout (st ri na) ; 
dataCstrina, 17); 
s 1 eep ( 2 ) ; 

) 

> 
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VIII 



TRANSVERSE DATA MODE 



This mode is designed to allow the user to cefine and 



draw 


irregular images 


i n 


the vertical 


plane 


(8 elements 


wide) 


of the R A M T E K . Th 


e s e 


figures 


snould 


be in 


a single 


color; 


as the facility 


for 


c h ang i ng 


col o r s 


w h i 1 e 


process i ng 


an image coes not exist 


w h i 1 


e in the 


transverse data mode. 



The user must gain a superficial unoerstanoing of how 



the RAM T E K 


processes hi 


s data in this 


mode 


to be 


ab 1 


e to 


use the 


mo Oe 


effectively. 


The 


bit cat tern 


of a 


set 


o f 


user 


de f i ned 


da t a 


words (bvt 


es ) 


describes 


the 


i mage 


t o 


be 



displayed. The user will define data words or bytes; regard- 
less of which he chooses, the P A m T E h interprets the data 
byte by oyte (a Oyte consists of eight bits). The bit oat- 
tern of each oyte turns ON or OF^ individual pixels on the 
R A M 1 E K screen* 



An octal number 


in the 


C 


programmi ng 


1 anauage 


C 3) 


i s 


denoted by a leading 


zero. 


The 


octal form 


o f numbe r s 


will 


be 


used exclusively in 


prepar i 


no 


t ransverse 


data, since 


i t 


i s 



simpler* If the user was to cefine the data word ,# x " as ”x 
= 01502c! (x is of type intecer) then it's bit by bit 
representation for the system would be: U 001 10100 0010 010. 
The R A v T E K would further decompose this wore into two data 
bytes (00011010 and 00010010). The data bytes are then pro- 
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cessed Dy the R A M T E K sequentially# beginning at the user de- 
fined starting ooint (see "strtxv") . The eight pixels to the 
right of this point are i nteroretea as either ON or OFF 
depend ina on the value. of it’s corresponding bit in the data 
byte* A one indicates that the oixel is to be turned ON; 
zero indicates the OFF state. Each consecutive byte is then 
written immediately below the last one until all are pro- 
cessed (see " data" ) . 



A. BASIC USER GUIDELINES 



Two very likely applications 
mode are definition and display 
regular vertical images. Software 
vioed to allow the user to perform 



for the transverse data 
of special symbols and i r - 
support routines are pro- 
these actions. 



1. SPFCIAL SYMBOLS 

A common use of the transverse data mode would be to 
define special symbols that are not providec in the stan- 
dard character set. For example# the user may desire to 
display the lowercase Greek letter alpha. By defining this 
letter in a linear array of length six (words)# and calling 
the system support function " symbol f s y ) M # where ” s y ” is the 
array name# the user may display this special symbol auite 
eas i 1 y . 

To define a special character the user should first 
draw a matrix (8 bv 12) and develop a graphical reoreseota- 
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t ion or r h a r character 



For exam Up; the lowercase Greek al- 



pha a* o u 1 n nel 



fa Y I l 




f h e ^ e x t steo for the user would be to transform * h * s 
graphic reoresentat ion into a data representation t n a * can 
he utilized by the support package. Transforming the grac- * 
cal representation cf the lowercase Greek alpha into a vi- 
able data representation is accomplished as follows: 

a. Transform the graphical view into the binary 
representat ion. 

(- represents a blank ; * a dot J 



Hr If. GRAPHIC HI GARY 

1 0 0 0 0 0 0 0 0 

<? - 00000000 

3 00000000 

a - - * * - 001 0 00 10 

5 .*-*-*-- 0 l 0 1 0 1 o 0 

o * * 1 0 0 0 1 0 0 0 

/ -*-*-*-- 0 1 0 ) 0 1 0 0 
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0 0 1 00 0 ] o 



9 



00000000 



10 
1 1 
12 



00000000 

00000000 

00000000 



b. v arr y pairs of bytes into ^ords 
sequentially frorr the beginning. 



This is done 



BYTES 




BINARY NUMBER 


1 


and 


? 


oooooooooooooooo 


3 


ana 


a 


U 0 0 0 0 0 0 0 0 0 1 0 0 0 1 0 


S 


and 


6 


01 01010010001000 


7 


and 


6 


010101000010 0 0 10 


9 


and 


1 0 


oooooooooooooooo 


1 1 


and 


12 


oooooooooooooooo 



These six w o r d s * represented in their cinarv number 
form/ provide the most basic data form of the lowercase 
Greek aloha, 

c. Transform the binary reoresentat ions into octal 
numbers for processing, Tni s binary to octal transfor- 
mation is done from right to left. Each binary word is 
divided into 5 grouos of three binary a i a i t s r with one 
binary digit left over. The oosition of the ones in 
these aroupincs represent powers of the number two. The 
leftmost diait represents two sauared when a one is in 
this location. The center diait / * h e n on e / represents 
two to the first cower. The rightmost digit represents 
a one (two to the zero cower) • Sum the numbers in each 
group of three to yield one octal a iait. 



Ex : 

0101010000100010 
0 101 010 000 100 010 

0 5 2 0 4 2 

Thus the octal representation would bet 0052042. 
d. An octal word/ as previously stated/ is denoted by a 
leading zero. The followina six octal numbers represent 
the lowercase Greek alpha descrioed above: 

0000000 
0000042 
005221 0 

005204? 

0000000 

0000000 

Mow that the user has an octal number to define the 
special svmool/ he mav Generate that symbol by calling the 
system support routine "syrcol (sv)"/ where "sy" is the name 
of the user defined arrav containing the octal definition of 
the symbol. The user should verify t h a t the octal code list- 
ed above is correct. 

a. PROGRAM 10 

Tnis program is desianed to show the user the 
mechanics of building a special symbol and displaying that 
symbol on the R A v j E K . The Greek lowercase alpha will be 
displayed in standard size ana dounle width. 
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( 1 ) T o use c s 2 0 0 0 type: 

LOGIN: c s2 0 0 0 c/r 
PASSWORD: student c/r 

cd ramtek c/r 

(2) To list the program: 

list ~c pIO.c c/r 

(3) To execute tne croaram: 

d 1 0 . x c/r 

(R)Proaram List i no: 

/♦DECLARE ARRAY*/ 
int aloha to] {0000000, 0 0 0 0 0 a 2 , 
0052210, 00520U2, 
0000000 , 0000000 ); 

ma i n ( ) 

(ra^tekC); //initialize 
strtxv(50. 0,50.0); //set COP 
colort(7); //select color fade 
c o 1 o r ( 2 ) ; //color 2 
symbol Calpha),’ //outcut aloha 
adlwid(t); //set double width 
strtxy(50. 0,30.0); //estaolish COP 
svmoo 1 (aloha); 

) 

2. IRREGULAR VERTICAL IMAGES 



It is auite plausible to consider toe use of the 
transverse data mode to define irregular images. The system 
software supports the desian ana disolay of columns of in- 
formation via the function " t da t a ( tot r , by / ex , 1 v ) " , where 
" t o t r " is the name of the array (pointer), "by" is the 
mumper of bytes to be outout, "ex" is the oesireo starting x 
value, and " 1 y " is the desired starting y value. 



The user might desire to develop a set of oversized 
parentheses for a special application. This is accomplished 
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by first aef i ni nq the i m a a e as discussed in the previous 
section, then via "taata" creating the display* Sucocse that 
the user has aef i nea his virtual screen to be 100 Dy 100, 
with (0,0) in the lower left corner* Perhaps he has use for 
a set of oarentheses that encompass 20% of the screen or, 
more specifically, 4 6 real screen lines ( . 2 * 24 0 n a 8 ) . He 
must then define 48 bytes oer image to accomplish this task* 
The definition of the data is as discussed previously. 

a. PROGRAM u 

This procram shows t^e user the definition of a 
set of parentheses, as discussed aoov^, and how to create 
the images on the screen of the p A^TEK. 

( 1 ) T c use c s 2 0 0 0 t v o e : 

LOGIN: c s 2 0 0 0 c / r 
PASSWORD: student c / r 

cd ramte'< c/r 

(2) To list the program: 

list -c r 1 1 . c c/r 

(3) To execute the crooram: 

p 1 1 . x c/r 

(^)Prograr listina: 

i n t 1 p a r e n ( 2 4 ] { 0 C 0 0 4 0 1 , 0 0 0 0 4 0 3 , 0 0 0 1 4 0 3 , 

000300b, 0003014, 0 0 0601 q, 
0014030,0014060,0030060, 
0060140,0060300,0140300, 

0 1 4 0 3 0 0 , 0 1 4 0 1 4 0 , 0 0 6 0 1 4 0 , 

0030060, 0030^30, 0014030, 
0006014,0006006,0003006, 

0 0 n 1 4 o 3 , 0 0 0 1 4 0 1 , 0 U 0 0 4 0 1 } ; 
i nt r p a r e n f 2 4 ] ( 0 1 0 0 2 0 0 , 0 1 0 0 3 0 0 , 0 1 4 0 3 0 0 , 

006U 140, 0060060, 0030060, 



0 0 1 a o 3 o , 0 o 1 a o i a , o o o o 0 1 a , 
0003006,0003003,0001403, 

0001U03, 000140O, 0003006, 

0006014, 000o030, 0014030, 
0030060,0030140,0060140, 
0140300,0140200,0100200}; 

mainO 

{ramtekO; //initialize 
colort (7) ; c o 1 o r ( 2 ) ; //colons 
triata(loaren,48,40 # 0 ,60.0) ; //cutout 
tdataCroaren,48,60 # 0,60.0) ; //cutout 
} 

The function " t a a t a M allows the user to paint 
portions ( or all) of t^e screen by adjusting to the next 
column when screen overflow occurs. The user neeo not wcrrv 
about doing off the bottom o * the screen. 



b. PROGRAM 12 



This proaram s h o * s the reset action of the func- 
tion "taata" . Data is oassea to the routine that is much too 
long to be displayed in a sinale column, thus it oaints to 
the r i q h t . The image crawn is a dot tec line. 

C 1 ) T 0 use cs2000 tyoe: 

LOGIN: c s2000 c/r 
PASS/' CRD: student c/r 

co ramtek c/r 
(2)To list the program: 
list -c p 1 2 . c c/r 
( 3 3 T 0 execute the crooram: 
d 1 2 . x c/r 

(4)Procram listina: 

int t e s t f 3 0 0 ] ; 

mainO 

{int i; ramtekO; //initialize 



1 0 h 



/^initialize array*/ 
for(i=0fi<300;i++) 
t es t. ( i 1 = 0 l ; 

color t ( 7 ) ; color (2) ; //colors 
tdata(test/6O0* 10.0/40.0); 

} 

The user should now possess tne skills required 
for processing the vast majority of his transverse data ap- 
plications. The next section will discuss some of the 
specifics of the moae for more advanced applications. 

B. ADVANCED METHODS 

The user who desires to execute sc me process that re- 
quires more flexibility Jinan provided in the previous sec- 
tion will have to crop down one level in the support package 
to the more fundamental functions for processing transverse 
data. The most fundamental function in the support paCKaqe/ 
in relation to transverse data/ is " data(name/bytes) " . The 
"data" routine simply sends raw data to the PA v - TEK from the 
array "name" for the specified numoer of "bytes". 

The user must/ at this level/ oe responsible for setting 
the mode (see "set-mode")/ establishing the current operating 
point (see" strtxy" ), ana orcvidina his own oroarammatic con- 
trol. The data definition process is the same as discussed 
in the BASIC USER GUIDELINES section. 

The control f 1 aqs that are applicable in the transverse 
data mode are: 

INDEXED ADDRESSING 
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REVERSE BACKGROUND 



ADDITIVE WRITE 
DOUBLE WIDTH 

The user must select all of his flags ana proviae the 
mechanism for their implementation. Comoli eaten transverse 
data applications reouire much attention to detail for suc- 
cess. For more scecifics the user is encouraged to peruse 
the R A M T E K Prooramminc Manual fl)» in the Lab. 
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IX. RASTER DATA MODE 



The Raster data mode/ except for the direction of the 
writing/ is like the Transverse data none. The Raster data 
node writes across the screen vice down the screen. The 
utility of this moae is that it allows the user to effi- 
ciently draw irregular inaaes of various shapes and sizes. 

The very nature of user aoclications for this tyce of 
processing dictates that it be utilized at a lower level 
than previous data ncces. The user may cefine and draw any 
image that he can conceive. The user must/ however/ provide 
all programmatic control himself/ as nothing is assumed. 

The applicable control flags in this mode are: 

INDEXED ADDRESSING ( s^e " i ndex " ) 

REVERSE BACKGROUND (see" o k a r n d " ) 

ADDITIVE ft RITE (see"wri ton" ) 

DOUBLE 1 /; ID T h ( S ee"si ze" ) 

The user should recall from previous chapters that to 
place the RAMJEK in a particular mode of operation the "set- 
mode" software support function is utilized. To ol ace the 
RASTER in the Raster cata mode a call of the form 

setmone(2/y) ; 

would oe issued. The argument " y" determines if previous 
flags are to ce saved. If " v " is a one (l)/ then all prior 



flags are saved/ if zero (0), then all flags are reset to 
the default values* 

The user who is unfamiliar with the generation of the 
octal data codes that define an iraqe should review the sec- 
tion on Transverse oata. The octal data form is recommended 
for it's simplicity* 

The software support function "data" is used to tran- 
sport the raw data to the R A m T E K for display. A call of the 
form 

d a t a ( x , v ) ; 

causes M y H bytes of data to be passed to the P A M T E K from ar- 
ray " x M . 

The following samole program is provided to assist the 
user in developing his expertise in tho use of the Paster 
da t a moce : 

A. PROGRAM 13 

This prodram is designed to show the user a specific use 
of the Raster data mode* The program draws a set of inter- 
secting lines much like a grip system or data record. The 
versatility of the Raster oata moce is only restricted cy 
the users imagination, 

1. To use cs20Q0 tyoe: 

LOGIN: c s 2 0 0 0 c/r 



PASSWORD: student c/r 



ca ramtek c / r 



2 . To list the proaram: 

list -c c 1 3 . c 

3. To execute the program: 

D 1 3 . x c / r 

4. Program Listing : 

/ * Define a horizontal line * / 

In (18J {0177777,0177777,0177777,01 77777,0177777, 

0177777,0177777,0177777,0177777,0177777, 
0177777,0177777,0177777,0177777,0177777, 

0 1 77777,0 1 7 7777,0 1 77777 } ; 

/♦Define vertical seaments*/ 

d i v 1181 {OiaOOOJ, 03, 03, 03, 03, 03, 03, 03, 03, 03,03,03, 
03,03,03,03,03,031; 

m a i n ( ) 

{int i , j ,’ float s x , s y ! //declare variables 
sx = 160.0; sy = 180.0; 

r a m t e k ( ) ; //initialize system 
colort ( 7 ) ; //establish color table 
setmode(2,0); //establish raster mode 
c o 1 o r ( 2 ) >' //select color 

screen(0. 0,0. 0,640. 0,240.0); //dimension screen 
/* 

OUTSIDE LOOP CONTROL 
* / 

f o r ( j = o ; j < l 2 ; j + + ) 

{ s t r t x y ( s x , sy ) ; //estaolish start point 
sy = sy - 1; //decrement y 
aa t a ( 1 n , 3b ) ; 

/♦INSIDE LOOP */ 
for(i=0;i<18;i++) 

{ da t a ( c i v , 36 } //send data 
sy = sy - 1 ; 

} 

sy = sy + 1 ; 

} 

dat a ( 1 n , 36 ) ; 

} 

The user should now possess the required skills to 
develop his own soecial imaoes as required. For further in- 
formation on this mode the user is encouraged to read the 
RAMTFk Prodrammers Manual (11 in the Lab. 
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COMPLEX DATA MODE 



This mode writes data to the P A M T E K screen in the same 
manner as the Raster data moa e» exceot that it allows the 
user to define the color of each pixel as it is painted. 
This third dimension of color does have some overhead asso- 
ciated with it/ in that now the user must define the color. 
The color definition reauires four (4) bits o e r pixel vice 
one (1) bit oer pixel in the other two a a t a modes. The im- 
pact on the user is that where one cata wcra describes six- 
teen (16) oixels in either Raster or Transverse oat a / it 
only describes four ( 4 ) oixels in the Complex data mode. 

The obvious benefit of this mode is that the color of 
images may be modified on a oixel bv oixel basis. The four 
bits required to define a color allow the user to address 
any one of fifteen (15) colors in the current color Icok-uo 
taole. The user must construct his data words now using 
binary coded decimal as an addea steo orior to converting to 
octal . 

The color definition of each oixel must oe done by the 
user, then oassed to tne software supoort o roqramma t i c a 1 1 y . 
This color definition reauires the use of 4 - 0 i t binary 
groups (called binary coaed decimal). These groups are com- 
bined into lo-oit cinary oatternS/ then converted (ov 3-bit 



arouos) to octal. Suocose the user wishes to define a word 
that selects four ( 4 ) oixels and colors them according to 
the colors one, four, seven ana eleven of the current color 
look-up taole. To accomplish this task he must convert the 
desired color entries ( 1 , '4 , 1 , 1 1 ) to binary codec decimal 
form as shown below: 

DECIMAL BIMRY CODED DECIMAL 

1 000 1 

a oioo 

7 0 111 

11 1011 

The binary cooed decimal numoers are then combined into one 
binary word. For the aoove example this numoer would be: 

0001010001111011 

This binary number must then be transformed into an octal 
representation as discussed in the chanter on Transverse da- 
ta. The octal reoresentat ion for this examole would be 
001B175. The user must perform this data transformation him- 
self. 



Once the data words are oronerl y defined, the user need 
only place the RAMTEK in the Complex mode with a call of the 
f o r m 

setmode(3, f) ; 

where " f M determines if previous control flags are to be 
saved or destroyed ( f = 1 save ; f = 0 destroy). Having esta- 
blished the mode of operation the information is now passed 



to the RAMTEK with a call of the form 



da t a ( x 9 n ) ; 



which causes " n H bvtes of raw data to be passed to the 
TEK from the array " x". 

The follow i n a control f 1 aas are applicable 
operating in the Complex mode: 

INDEXED ADDRESSING 

REVERSE BACKGROUND 

DOUBLE WIDTH 

The following samole program is provided to assist 
user in developing expertise in the use of the Complex 
mode : 

A * PROGRAM 14 

This program is designed to demonstrate the Complex 
mode. Its execution causes the entire display screen 
painted with alternating bands of the first seven color 
color table seven. T n e screen is t n e n partially erased 
triangle w i t n similar properties is displayed. 

1. To use c s 2 0 0 0 tyoe: 

LOGIN: csBOOO c/r 
PASSWORD: student c/r 

cd rente* c/r 

2. To list program: 

list - c o 1 '4 . c c/r 

3. To execute program: 



1 1 4 



Ram- 

while 



the 

data 



da t a 
to be 
s i n 
ana a 



o 1 4 * x c/r 



4. Program listina 



int 1 [ 1 o 1 ] ; //aeclare array 
inainO 

(int iij/kl float s x , sv ; 
ramtekC); / / i n i t system 
se t mode ( 3 , 0 ) ; //estaolisn mode 
/♦INITIALIZE ARRAY 1 */ 

f or ( i =0 ; i < 1 o 1 ; i = i > 14) 

{1 C i 1 = 1 ti >1) =0073567; 

1 ti +2) =1 li +3] >0063 146,* 

1 (i + 4) =1 [i +5] =0052525; 

1 [ i + 6 1 = 1 C i +73 = 0042104; 

1 [ i >81 = 1 [ i +9] =003 1 4o3; 

1 Ci >10) =1 t'i + 1 1] =002 1 042; 

1 1 i >121=1 ti >13) =0010421 ; 

1 

screen! 0.0, 0.0,640.0,240.0); //dimension screen 
colort(7); //select color table 
k = 320; sx = 0.0; S y = 0.0; 

/ * 

PAINT SCREEN 
*/ 

f o r ( i = 0 ," i < 2 4 0 ; i > + ) 

<strtxy(sx,sy); 
da t a ( 1 , k ) ; 
s y = s y > l ; 

> 

/* ERASE PORTION OF SCREEN */ 
terse(40.0, 10.0,6 0 0.0,230.0); 
sx = 60.0; sy = 20.0; 
k = 100; 

/* 

DRAW TRIANGLE 
/* 

for(i=0;i<100;i+>) 

Istrtxy(sx,sy); 
dataCl ,<),* 
k = k - 1 ; 
s x = s x > l ; 
s y = s y > 1 ,* 

> 



VI. GRAPHIC V EC TOP M ODE 



A. INTRODUCTION 

The Grach ic Vector Moae is used primarily to draw lines 
or vectors between user-defined end points. It is relative- 
ly simple t; o use and/ oy its nature/ fits many aool i cat i ons , 
The user must be aware that excect in vertical or horizontal 
lines/ a noticeable quantization error or "stai r-casi na M ef- 
fect will a c c ear. This condition is caused by the low line 
resolution (2-40 addressable) versus hiqh element resolution 
(640) of the system, and by the very nature of the raster 
scan aevice. 

B. BASIC USER GUIDELINES 

To put the RAi^TEK aevice into this mode requires a call 
of the form 

setmode(4/Q); 

where 4 is the defined number for this mode and 0 indicates 
that all control flaos are to be turned OFF. If the second 
parameter was 1/ all flaos would be left as set oreviously. 

The first two routines presented below actually set the 
proper mode themselves (by calling " set mode M internally); 
althouqh/ as previously mentioned/ the use of "setmoce" in 
the user’s program is considered standard practice. These 



are "vector" and " p 1 o t 1 n 



The first acceots as Parameters 



two sets of virtual screen coordinate pairs and draws a line 
between the two points that they define. It's call would ap- 
pear as follows : 

vector (xl ,yl , x 2 , v 2 ) ; 



The second accepts two eaual length arrays of real 
numbers and an integer value to denote that length. It then 
plots the points described by the correscondina x,y values 
and connects each successive point with a line from the pre- 
vious one. Thus if two arrays were declared ana initialized 
as follows • 

float p* [nl {xl/x2,x3,....fxn>; 
float pytnl {yl,y2fv3,....fyn}; 
then a subroutine call of the form 

plotln(px,py,n); 

would correlate the respective values from the two arrays 
and plot the points with connecting lines. 



Another routine which actually sets the orooer mode by 
itself is one wnicn might b « utilized in conjunction with 
” p 1 o t 1 n " . This is the 11 axis*' routine. As implied by its 
name* this subroutine draws a coordinate axis on the screen 
accordina to the two real numbers it accepts as parameters. 
It woul c be called as follows : 

a x i s C x f y ) ; 

where x and y represent the desired virtual screen values 



for the intersection of tne axes 



c 



advanced methods 



At the next level Down in the structure of the software, 
there are several routines which are highly functional in 
this system. The first of these is the procedure for estab- 
lishing a new Current Ooeratina Position (COP). To reiterate 
its usage, a call of the form 

strtxy (x,y) ; 

where x and y are real n u m b e r s , would establish the COP at 
that virtual screen location. From there, a vector could o e 
drawn to another point by utilizing either the ,, ooint" or 



"Dointr" 


rout i nes in t h i 


s mode . A 


cal 1 


o f 


the form 










ooint ( x , v ) 


, 












with the 


parameters recr 


°sentinc the x 


ana 


y 


values 


for 


the 


des i red 


ooint, would 


draw a vector 


from 


the COP 


t c 


that 


ooint ana 


establish the 


COP at the 


new 


c o i 


n t 


. C ur 1 


ess 


the 



fixed point flag was ON) 



In similar c i r c um s t an c e s , a call to 

oointr(ox/dv) ; 

would draw a vector from the COP to a point "relative'* to 
the COP as determined by the "change" values passed as 
parameters. H ere again the COP would be established at the 
newly calculated ooint unless the fixed point flag was ON, 



As mentioned in "Control Mooes ana Flags" (Chao IV), the 
fixed point flag is turnea ON and OFF by a call to 

fixot(f); 

where f is given the value 1 to turn ON the flag or the 



value 0 to turn OFF the flag- 



If this flag is ON# a call to "strtxy" establishes a 
fixed ooint from which all suosequent vectors will be drawn 
by calls to "point" or "oointr" , In effect# it freezes the 
COP until the occurrence of another "strtxy" command or un- 
til the flag is turnec OFF. 

The user should be aware that each time the fixed ooint 
flag is turned ON# after having been OFF# a new "strtxy" 
call is REQUIRED to establish the desirea fixed position. 
The flag cannot be sirrcly tooglea ON ana OFF amiast a series 
of "point" and/or "oointr" calls# without erratic results. 

Other flags which affect the ooeration of subroutines in 
this mode are the Indexed Addressing f 1 a a , which was ex- 
plained in " Virtual Screen Agcressinq"# and the Reverse 
Background flag# discussed in "Co n trol Hoaes and Flags". 

i. PROGRAM 15 

The sample program listed below is available in the 
" c s 2 0 0 0 - r a m t e k " directory to illustrate a variety of the 

described routines. Selective delays have been employed in 
the program to allow the viewer to notice the following : 

1. the change of background color when "colcrt(7) M is 
executed (because the "ra^tek" routine initializes to 
color table 0); 

the efficiency of "ol ot In" in drawing the first three 
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sines of the star; 



3. the use of "oointr" to draw the fourth si ae relative 



to the third; 

a # the use of "vector" to draw the final side; 

5 . the use of the fixed point m e t n o a for drawing lines 
from the center to the extreme points of the star, 
with "point M ana "oointr” • 

The user should realize that "olot In" establishes 
its own initial C h p at the first ooint ana leaves the COP 
located at the last coint that it plots# he should also be 
aware of the location of tn.e COP before and after each of 
the other disolav routines are called, Notice that "strtxy" 
is used only once - - immediately after turning on the fixed 
ooint flag. 

The figure displayed by this program illustrates 
dramatically the 1 stair-casing* effect that occurs when 
drawing lines at various anal es on the screen. The user may 
also notice that a horizontal line is slightly ’fatter' than 
a vertical one cue to the afore-mentioned difference between 
line resolution and element resolution in this system. 

a. To use tne c s 2 0 0 0 directory : 

LOGIN: cs2000 c /r 
PASSWORD : stucent c/r 

cd ramtek c/r 

b. To list the program : 

list -c ots.c c/r 
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c/r 



c. To execute the orogram : 



d 1 5 . x 



c / r 



The listing follows 



float p x C 4 1 {-'-I. 

float pyt^l {-o. 
i nt pn 0 ; 
ma i n ( ) 

< i n t i > 
ramtekO; 
sc reen ( - 1 0 . 0 , 
s 1 eeo ( 2 ) ; 
c o 1 o r t ( 7 ) ; 
s 1 eeD ( 2 ) ; 
c o 1 o r ( 5 ) ; 
setT>oae(U/0); 
plot 1 n ( o x , o y , 
s 1 eeo ( 2 ) ; 
pointr(13.0,0 
s 1 eep ( 2 ) ; 
vector(6.5,2. 
s 1 e e p ( 2 ) ; 
c o 1 o r ( 1 ) ; 
f i x o t ( 1 ) 7 
st rtxv(0.0f 0. 
pointr(o.5,2. 
s 1 e e o ( 2 ) ; 
for(i=0;i<0;i 
{ do i n t ( dx [ i 
s 1 eeo t 2 ) ; 

> 

> 



0,0.0,u.0,-b.5>; //Declare array 

0,b.5, -6. 0,2.0} ; // 

//declare array length 



//ocen the dev i ce 

-10.0,10.0/10.0); //set screen size 
/ /Da us e 

//select color taol e 7 
/ /cause 

//select color 5 

//set graphic vector mode 
cn); //olot the array points 

//cause 

.0); //draw line relative to COP 

//pause 

0, -0.0, -6.0); //ora* with "vector" 
//cause 

//select color 1 
//turn Oi'j fixed point flag 
0); //set start i na ooint (COP) 

0); //draw first line relative to COP 
//cause 

+ + ) //draw remaining points 

1 , o y C i I ) ; // from fixed COP 
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GRAPHIC plot mode 



XII . 



A. INTRODUCTION 

The primary function of tne graphic plot mode is to gen- 
erate the display of a histogram style plot. In effects 
this means to shade or color the area Detween a selected x 
axis and a line defined oy user-generated coints. This shac- 
ina is actually accomplished ov drawing a series of vertical 
lines adjacent to each other. The software that accomplishes 
this is built arouna a R A M T E K hardware feature in this mode 
which automatically increments the element address by one 
after each line is drawn. Thus after the starting element 
has been established* each successive element (proceeding 
left to right) is individually addressed* until the final 
point is reached. As eacn element is addressee* a vertical 
line is drawn from a cre-selected common line or ' x axis* to 
the proper line address or y value. Tne most obvious appli- 
cation is clotting a 'function' and shading the area between 
that 'function' and a certain x axis. 



B. BASIC USER GUIDELINES 

To select the a r a o h i c olot mode the user should make a 
subroutine call of the form 

setmode(5/0); 

where 5 is the defined number for this mode and 0 indicates 
that all control flags are to be turned OFF. If a 1 were in 
this posit ion# all’ control flags would be left as set previ- 
ously. 

This mode i s / in effect/ implemented in one routine 
called "cloth". This routine clots a set of x , y coordinate 
points/ as did "olot In" in t h e previous c^aoter , a no th^n 
shades the area 'under the curve' as described above. As 
with "olot In"/ the "cloth" routine requires two equal length 
arravs of real numbers that describe the 'function' to be 
plotted/ and an integer value that denotes the length of the 
arrays. It also reauires, as a fourth parameter/ the real y 
value (represent ina the x axis) from which the clot should 



s t a r t . 


Thus a 


call to this 


routine would 


be as follows 


• 








D 1 o t h ( p 


x/oy,n,base) ; 










where 


"px" and 


"cv" ere tne 


names of the 


a r r a y s / 


" n " i 


s 


the 


length 


of the 


arravs , and 


"base" is the 


desired 


base 


o f 


the 


histogram olot 


. For crooer 


results/ the 


x values 


must 


oe 


ar* 



ranged in ascending order in the array. 
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PROGRAM 16 



This sample orogram, available for execution in the 
" c s 5 0 0 0 - r a m t e k " directory/ will illustrate the histogram 

style plot achieved ny M n I o t h " . p rior to o 1 o t t i n a the histo- 
gram/ a set of axes/ that will coincide with the center of 
the plot/ are oosi t ionea on the screen. The user should note 
that the histogram overlaos and wines out these axes in the 
areas that are common to t n e two displays. I f the "axis" 
call had been olaced after the "piotn" call/ this condition 
would be reversed. Trie routine "ol ot In" is also called with 
the same data to ocint out the relationship between these 
two routines. (Note : The 11 setmode" calls could nave been 
omitted/ since both "cloth" and "olotln" set their own re- 
aui red moaes internally.) 

a. To use the cs5000 directory : 

LOGIN: csPOOO c/r 
PASSWORD: stucent c/r 
cd ram t e < c/r 
0. To list the crcqram : 
list - c oio.c c/r 

C/r 

c. To execute the program : 

olb.x c/r 

d. The listing follows : 

float px [40] <3.0/3. 1/3. 2, 3. 3/3. 4/3. 5/3. b/3. 7/3. 8/3. 9, 
4.0,4. 1,4. 2/4. 3/4.4, 4. 5, 4. 0/4. 7/4. 8/4. 9/ 

5. 0/5. 1/5. 5/5. 3/5. 4, 5. 5/5. P/5. 7/5. 3/5.°/ 

o. 0/b. I/O. 5/0. 3/6. 4/6. 5/6. 6/b. 7/6. 8/0.9); 
{^.0/3.0/3.0/j>. 1 / 3. 5/3. 4, 3. P/3. 9/4. 3/4.6/ 
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float p y [40] 



5. 3, 5. 6, 5. 9, 6. 1, 6. 3, 6. 5, 6. 6, 6. 7, b. 8, 6. 9, 

o. 9, b. 8, 6. 7, 6. 6, 6. 5, 6. 3, o. 1,5. 9, 5. o, 5. 3, 
a. 6, a. 3,3. 9, 3. o,3. a, 3. 2, 3. 1,3. 0,3. 0,3. o>; 

i n t pn 90 ; 
float phase 5.0; 

mainO 

{ramtekO; //open the device 

screenCO. 0,0. 0,10.0/10.0); //set dimer. sions 
colort(7); //color table 7 

colord ) ; //color 1 

axis(9. 95,5.0); //fra waxes 4 

sleeo(3); //oause 

C o 1 o r ( 7 ) ; //color 7 

setmooe(5,0); //select qracnic olot mode 

p 1 ot h (px / oy / on / obase ) / //olot histogram 

sleeo(3), //oause 

color(S); //cnanae color 

se t mode ( 9 , 0 ) ; //chanae mode 

plot 1 n(ox /oy,cn) ; //olot the 'function' 

> 



c. advanced methods 



The use 


of the araohic clot 


frode 


for 


any 


more 


de t a i lea 


operations 


than can be acco^ol 


i s h en 


by 


the 


" 0 1 0 t h 


" routine 



will require the user to consult the RAMTEK Gx-100 Program* 
m i n g Manual 111. 
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XIII 



GRAPHIC CARTESIAN MODE 



A. INTRODUCTION 

The graphic cartesian mode is used to draw solid rectan- 
gles on tne R A M T E K screen. These rectanoles must be defined 
by two diagonally opoosite corner coints , the second of 
which becomes the new COP after completion. Since these 
rectangles may be displayed in any color/ the user/ by 
choosing the background color, can effectively use this mode 
for selective erasure of rectangular areas* 



8 • BASIC USER GUIDELINES 

Selection of the graphic cartesian mode can be achieved 
by a call of the form 

setmode(6, f) ; 

where 6 is the defined number for this mode* The parameter 
M f" should have the value 0 to turn OFF all control flags, 
or the value 1 to leave all flags as they were set prior to 
this c a 1 1 * 

The simplest imolementaticn of this mode is throuah the 
M block” routine* The user must first have selected his 
desired color by using the "color" routine* Then the call to 
M block M , which reauires four real nymoer parameters/ would 



appear as follows : 



b 1 OC k ( x 1 , y l , X 2 , v2 ) ; 



where the two respective coordinate pairs define two vdiago- 
nally oooosite corners of the desired bloc* to be displayed. 
The resulting COP will be located at the point (x2,y2), the 
last to be transmittec to the F A T E K . 

The " block" routine does out the R A M T £ K into the graphic 
cartesian mode by itself and it also does some fairly ela- 
borate error checkina. But a quick: scan of the source code 
would reveal that the actual rectangular oi sol ay is generat- 
ed ov issuing a " strtxy" call followed ov a " point’ 1 call. 
The user is, of course* fr^e to utilize these routines also. 
In fact, in some aooli cat ions they are essential. 

Thus after selecting the croner mode and color, the user 
could create the same disolay as the "block” call above by 
issuing the following two subroutine calls : 

Strtxy (xl,yl); point(x2,y2); 

(assuming the parameter values were the same as above). 

C. ADVANCED METHODS 

Although the oasic results are the same, a variety of 
approaches are available. Some users may find the " c o i n t r ” 
routine convenient in applications where relative aocressinq 
becomes easier to compute than acsolute. Thus after using 
the ” strtxy” routine to establish an initial COP, the 
"oointr" routine could be called repeateal y (as could 
” point”) to generate a series of lin<ec rectangles. 
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There also may be certain applications in which the in- 
dexed addressing feature is useful. This may be implemented 
by the "index" routine explained in Chapter IV under "Virtu- 
al Screen Addressing". 

1. PROGRAM 17 

This sample program is available in the " c s 2 0 0 0 
ramtek" directory t c graonically demonstrate the effect of 
the separate routines in this mode. The user should observe 
the following : (t) the use of "clock" to draw a clock in 

the upper left auaarant of the screen; (2) the use of 

"strtxy" and "point" to draw a similar Clock in the upper 

right quadrant; ( 3 ) the use of relative addressing when us- 
ing "oointr" to generate two small Coxes in the lower right 
quadrant; (4) the use of indexed addressing to Position 
three small boxes in the lower left quadrant; (5) the 

'selective erasure' effect achieved by selecting color 0 ana 
drawing over cart of the block in the uocer riaht Quadrant . 

To assist the user in accessing this Program the 
following guidelines are provided : 

a. To use the c s 2 0 0 0 directory : 

LOGIN: cs2000 c/r 
PASSWORD: stucent c/r 

Cd ramtek c/r 

b. To list the Program : 

list -c ol7.c c/r 
c/r 
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c • To execute the program : 



p 1 7 . x c / r 

d. The listing follows l 

mainO 

(ramtekC); //o oen the device 

ScreenCO.O, 0.0, 20. 0,20.0); //set oinnensions 
setmode (6, 0) ; //select qraohic cartesian mode 
c o 1 o r t ( n ; //select color table 7 
color ( 1 ) ; //select color 1 

block(3.0, 13.0,7.0, 17.0); //draw a block 
sleeo(2); //pause 

strtxy(l3. 0/17.0); //establish new COP 

point(17. 0/13.0); //draw a Mock 

s 1 eeo ( 2 ) ; / /cause 

c o 1 o r ( 3 ) ; //select color 3 

strtxy(17. 0,7.0); //establish new COP 

oointr(-2.0,-2.Q); //draw "relative" to COP 

oointr (-2.0/-2.0) ; // " " H " 

sleep(2); //pause 

color(i); //color 1 

index(l/l. 0/1.0); //"index” from (1.0/ 1.0) 

s t r t x y ( 2 . 0 / 2 . 0 ) ; //set new COP 

ooint(4. 0,4.0); //draw a block 

co 1 o r ( 5 ) ; //select color 5 

strtxy (3. 0/3.0); //set new C (3 P 

no i n t ( 5 . 0 / 5 . 0 ) ; //draw a block 

c o 1 o r ( 7 ) ; //select color 7 

strtxy(4. 0/4.0); //set new COP 

point (6. 0/6.0); //ora w a bloc* 

s 1 eeo ( 2 ) ; //pause 

inaex(0/0. 0/0.0); //turn OFF index flag 
color (0) ; //select background color 

block (13. 0/13. 0/15. 0/15.0); //"erase” Part of a 

> 
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block 



XIV. GRAPHIC element MODE 



A. INTRODUCTION 

This mode involves act i vat i no or 'painting' individual 
elements (oixels) on the R A M T E K screen. When ooerat i no in 
the qrapH i c element mode t^e user ^ lj s t compute/ either pro- 
grammatically or bv hanOf the virtual screen coordinates of 
each pixel that he aesires activated. As such/ its use may 
may not seem as attractive as some other mooes / yet for some 
applications this mode may prove extremelv useful. 

B. BASIC USER GUIDELINES 

The graonic element mooe may be selected bv a call such 
as 

set mode ( 7 / f ) ; 

where 7 is the cesicnated number of this mode. The second 
parameter (f) shoul a c e a 'O' to turn OFF all control flags/ 
or a • 1 * to leave the flags as they were. 

By its nature/ this mode oerranos an increased awareness 
of the virtual screen dimensions. The screen may be dimen- 
sioned to any size the user desires by a call of the form : 

screen(xmin/ymin/xmax/vmax) ; 

which will result in the minimum coordinate values 
representing the lower left corner of tne screen and the 



maximum values represent inq the uccer riaht. There are some 



instances 


when 


viewing 


the screen in 


1 t s 


'real' dimensions 


will help. 


This 


may 


be 


achieved by 


u s i 


na the "screen" 


rout i ne 


t 0 


set 


the 


6 4 0 by 


240 


dimensions by 



screen(0. 0,0. 0,640. 0,24 0.0). One of the more useful appli- 
cation routines in this mode is the "plotpt" routine. This 
procedure, as with " cloth" and " plot In" in previous 
chapters, requires as parameters two equal length arrays of 
real numbers and an inteaer value defining tnat length. Thus 
if tne follow inq arrays were declared and initialized : 
float p x ( n 1 {xi,x2,x3,....,xni; 

float oy[n) fyl,y2,y3,....,yn>; 
then the suoroutine call 

plotPt(px,oy,n); 

would correlate the 'n' values from "ox" and "oy" and ac- 
tivate those * n ' inai victual pixels on the screen according 
to the currently selected color. 

The "plotot " routine actually makes a series of calls to 
the familiar "point" function. In tnis mode, the M point" 
routine is usea t* o address individual elements on the 
screen, not to define the end point of some vector or block 
drawing procedure as before. Thus the user may utilize 
"point" to activate arbitrary pixels. This can be helpful 
when plottina some function whose values are not known 
beforehand, (see sample orooram below) 
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The "oointr 



routine mav also oe usee to address some 



element relative to the oreviousl y addressed element (loca- 
tion of COP)* The reverse background and indexed address inq 
flags which were explained in "Control M odes and Flags" 
(Chao IV) are apolicable to this m o a e • 

U PROGRAM 18 



The following o r c a r a m , when executed 
and plot the points alone the c i rc um f e r enc e 
the same timer it uses the results of its SIN 
putat ions to plot a cort ion of a sinp curve 
cle* This program is in rne " c s 2 0 0 0 - ramte<" 
can be accessed as follows : 

a* To use the c s 2 0 0 0 directory : 

LOGIN: c s 2 0 0 0 c/r 

PASSWORD: stucent c/r 

cd ra^tek c/r 
b. To list tne orcoram : 
list -c p l 8 . c c/r 
c/r 

c* To execute the program : 
p 1 8 • x c/r 

d. The listing follows : 



double s i n ( ) ; 
douo 1 e cost); 
float ox ; 
float o y ; 
float cr 3*0; 



//radius of circle 



fnainO 

{ f 1 o a t i f t ; 



will compute 
of a circle* At 
f unc t i on com- 
within the ci r- 
di rectory and 
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ramtekO; / / ooen the device 

sc reen ( -5 . 0 > -5 . 0 > 5 . 0 , 5 . 0 ) ; //set dimensions 
co1ort(7); //color table 7 

color(5); //color 5 

setmode(7/0); //select a r a o h i c element mode 
for(i = 0 . 0 ; i < o . 2 8 3 1 8 ; i = i + 0.01) 

{ox = or * cos ( i ) / 
t = s i n ( i ) ; 
oy = or* t ; 

oo i n t ( o x / o v ) J //olot the circle 

if(i < = 6.0) Doint((i~3)»t)» //olot sine 

} 



c. advanced methods 



The qraohic element mode seems best suited for clotting 
a series of ooints that are comouted by the apol i cat i on pro- 
gram itself. Depending on the desired d i s p 1 a y > some Projects 
that reauire the user to ore-comoute nis data ooints might 
be more adaptable to cne of the Data mooes. (see Easter and 



Transverse Data M odes) 



XV 



RAivTEK INTERACTIVE KEYBOARD 



The R A M T E K keyboard is software a d a o t e d to be utilized 
as an interactive tool by the RAi^TEK user. This keyboard 
(located in front of the G X - 1 0 0 A ) is ON when the green 
switch/light (in the upcer riant corner) is glowing; to ac- 
tivate tne Keyboard when it is OFF, aepress the 
switch/light. Tne keyboard is configured as shown in Figure 
3. 

Ref err i nq to Figure 3, the user will note that there 
are eighty-nine (69) keys. Eac K Key nay have f r o m one (1) to 
three (3) states (ucoercase, lowercase/ control). The user 
has available 237 distinct cooes that mav be transmitted via 
the keyboard/ with the ASCII code being utilized for all 
keys. The decimal representation of the actual code returned 
from selecting a particular key is shown in Figure ^ . 

The system software has been desianed to allow the user 
to read keyboard inout quite easily. The three functions 
that allow tne user to interact with the keyboard can pro- 
vide individual ASCII characters/ inteaer numbers/ or real 
numbers deoenoinq on the function utilized. 

In addition to reading from the keyboard/ the user may 
echo orint back to the PAMTEK screen individual ASCII char- 



acters as they are reac 



The system support routine "out (n) 



provides this capability ( " n " is an ASCII cooed character). 
The function "out (n)" automatically repositions the COP one 
character to the riaht to prevent over-writing. 

The function that returns individual ASCII characters 
to thp user is "retcharO". To read a character from the 
RAMIEK keyboard the user would issue a call of the form 

x = retcharf); 

This will result in M x ” bei no assigned the value of the 
selected key . 

A. PROGRAM 1 9 

This proaram will r e a a / and echo print to the P A M T E K 
screen/ characters selected from the R A N ■ f E r\ keyboard (NOT 
ALL SELECTIONS ARE PRINTABLE). The program terminates when a 
single carriage return is incut . 

1. To use the cs2Q00 directory: 

LOGIN: c s 2 0 0 0 c/r 
PASSWORD: student c/r 
ca ramtek c/r 

2. To list the program: 

list - c o 1 9 . c c/r 

3. To execute the proaram: 

d 1 9 . x c/r 

4. Proaram listing follows: 

^define CR 13 
mainO 

Tint x; //inteoer variable 
ra mtek(); //initialize 
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c o 1 o r t ( 7 ) ; c o 1 o r ( 2 ) ; //select colors 
while C ( x = retcharf ) ) - CP) //looo 

{strtxy(50. 0/50.0 ); //set cositon 
out ( x ) ; //echo character 
> 

> 

To read an integer from the R A M T E K , the user depends 
upon tne system function "aetiO". To read an integer quan- 
tity from the key board the user issues a call of the form 

y = ae t i ( ) / 

The function " g e t i ( ) " recoonizes a carriage return as the 
end of the incut value. To incut tne value one hundred the 
user woul o type (at the ^ A v T E h keyboard) : 

100 c / r 

A neaative one (-1) is returned if a carri aae return is 
typed as the first character. The only valid inputs are 
lowercase numbers; all others are ignored. 

8. PROGRAM 20 



Th 


is proaram all 


otvs tne user to 


incut i n t eae r 


values 


from 


the Keyboard 


un t i 


1 a carriage 


r e t u rn is 


t y oed 


as the 


first 


charac ter in a 


new 


number . The i 


n t ege r v a 1 


ue is 


ou t ou t 


to the 


RAfviTEK screen 


for 


user verification (see 


" i t o a 1 


( X ) " ) . 



1. To use the csPOOO directory: 

LOGIN: cs8000 c/r 
PASSWORD: stuoent c/r 
cd ramte< c/r 

2 . To list the Droaram: 

list - c c 2 0 . c c/r 
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3. To execute the crogra^: 



o2 0.x c / r 

4 . Program listing follows: 

tfoefine C R 13 
nn a i n ( ) 

< i n t k; //inteaer variable 
r a m t e k ( ) / //initialize 

colort(7); color(2); //select colors 
while ((< = qeti()) ! = CR) / / \ ooo 
{strtxy(50. 0/50.0); //set COP 
i t o a l ( k ) ; //output value 
} 

} 

To read a real number from the R A K T E K keyboard the user 
will call "aetf ()". The user would issue a call of the form 

y = ge t f ( ) 

to read a real number. The result would oe the assignment 
of a real number to the variable " y " • The function " get f ( ) " 
recoqni zes a carriage return as the end of the input value. 
Only lowercase numbers/ " e" for exponential/ " +" or M - " / ana 
" • M are valid inputs to the routine; all others are ignored. 



The user should now oe able to effectively use the key- 
board as a n interactive tool. For specifics on the functions 
see Aooend i x 3 . 
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F I bURc S 



1 i* 



1C- 1 owercase 
UC-uooercase 
C fRL-cont rc 1 



1 


145 


177 


209 


2 


146 


1 78 


210 


3 


147 


1 79 


21 1 


4 


148 


180 


212 


5 


1 49 


1*1 


213 


6 


1 50 


182 


214 


7 


151 


183 


215 


8 


152 


164 


21c 


9 


153 


185 


2 1 7 


10 


154 


1 8 6 


218 


1 1 


155 


1 87 


219 


12 


156 


1 88 


220 


1 3 


157 


189 


221 


1 4 


158 


1 90 


222 


15 


159 


191 


223 


1 6 


91 


123 


27 


1 7 


ao 


33 


17 


18 


50 


34 


18 


19 


51 


35 


19 


20 


52 


36 


20 


21 


53 


37 


21 


22 


54 


36 


22 


2 3 


55 


39 


23 


24 


5o 


40 


2 4 


25 


57 


a 1 


25 


2e 


48 


46 


— 


27 


45 


6 1 


29 


2 8 


93 


125 


29 


29 


9a 


126 


3 0 


30 


92 


124 


28 


31 


1 33 


165 


197 


32 


137 


1 o9 


20 1 


33 


141 


173 


205 


34 


— 


— 


— 


35 


1 13 


81 


1 7 


36 


1 19 


87 


23 


37 


101 


69 


5 


38 


1 14 


62 


18 


39 


1 1 6 


8a 


20 


4 0 


121 


89 


25 


4 1 


1 1 7 


85 


2 t 


42 


105 


73 


9 


43 


1 1 1 


79 


15 


44 


1 1 2 


80 


— 


45 


6 4 


96 


— 


46 


95 


95 


31 


47 


1 0 


1 0 


1 0 


48 


13 


l 3 


1 3 


49 


— 


1 6 0 


192 


50 


134 


1 06 


193 


51 


1 38 


170 


202 


52 


142 


174 


206 


53 


— 


— 


— 


54 


97 


65 


1 


55 


1 15 


83 


19 


56 


100 


68 


4 


57 


102 


70 


6 


58 


103 


71 


7 


59 


1 U 4 


72 


6 


60 


106 


74 


1 0 


6 1 


107 


75 


1 l 


62 


1 0 8 


76 


12 


o 3 


59 


43 


27 


o 4 


58 


42 


26 


e5 


8 


8 


3 


o 6 


— 


— 


— 


67 


— 


16 1 


193 


06 


— 


1 46 


196 


69 


— 


162 


164 


70 


135 


167 


199 


71 


139 


1 7 1 


20 3 


72 


143 


1 75 


207 


73 


— 


— 


— 


74 


1 22 


90 


26 


75 


120 


88 


24 


76 


99 


67 


3 


77 


1 18 


36 


22 


78 


9 3 


66 


2 


79 


1 10 


78 


1 4 


80 


1 0 9 


77 


1 3 


61 


44 


60 


12 


82 


4 o 


62 


l 4 


63 


4 7 


63 


15 


84 


— 


— 


— 


85 


— 


l 6 3 


195 


86 


— 


1 68 


200 


87 


— 


1 72 


20 4 


36 


— 


1 76 


208 


89 


32 


32 


32 
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XVI 



SPECIAL APPLICATIONS ROUTINES 



The ourpose of this chanter is to present those 
routines from the software support cackaqe which are not an 
intearal part of any toDic discussed earlier/ ana which 
would otherwise be omitted. Some of the routines in the sup- 
oort package are merely subordinate oarts of larger routines 
and serve no stand-alone purpose. These will not be dis- 
cussed. The routines presented here are those that mignt be 
employed bv a user’s application oroararr. 

There is only one routine in the support package tnat 
requires <nowleoce of the fact that this device actually has 
512 raster lines - - 480 of which are visible and 32 of which 
are off the bottom of the screen. This is tne 11 scroll” func- 
tion/ which is used to make a display move ud or down by a 
certain number of real lines. If a portion of the display is 
’scrolled* off the too of th* screen/ it will *wrao around 1 
ana reappear at tne bottom (and vice versa). Thus the 32 
non-visiole lines that exist off the bottom of the screen 
must oe taken into consideration when making use of this 
feature. The subroutine call would apoear as 

scrol 1 (direct ion/numl i n e s ) / 

where the parameter "ci rect ion" must oe either a "u” for UP 
or a " d H for D 0 I'm / and the " n u m 1 i n e " parameter is a real 



number denoting the number of real screen lines the 



display 



should oe moved 



In previous chapters, screen addressing nas been 
presented in terms of the virtual screen. There are two 
routines that mao these virtual addresses into real (ana 
visible) screen locations for the actual disolay generator. 
These are "conve" and " convl ". The "conve" function con- 
verts the X coordinate into a r^al screen element oosition. 
The "convl " function converts tne T coordinate into a visi- 
ble real screen line n u m o e r • The coroinat ion of these two 
define an element/line intersection or pixel. These func- 
tions are used internally by all the software disolay 
routines to convert user-clef inea addresses to real screen 
locations oefore passing these to the RAMTEK buffer for 
display. These two procedures may be e m cloyed bv the user 
with individual calls such as 

ccnve(x); convl (y); 

where " x " and "y" are tne real numoers of the desirea virtu- 
a 1 sc reen aoar es s . 

In order to disolay a given integer value (in the range 
of -32767 to +32767) on the screen, the " itoal" routine may 
be used. This routine will convert the aiven inteaen carem- 
eter into its ASCII code ana display the desired integer 
value on the screen at the COP. The call would be 

i t o a 1 ( n ) ; 

where M n 11 is any valia integer value. 



Likewise^ t n e M f t o a " function may be used to display a 



real numoer with no more than nine digits to the left of the 
decimal ooint and no more than four digits to the right. 
Thus if " x " were a valid real number/ the call 

f t oa ( x ) ; 

would display the decimal reoresentat ion of that number 
(complete with decimal point) on the RAMfEK screen at the 
location of the COP. 



The "out" function takes/ as a s inale parameter/ the 
ASCII code for any valid character ana "dumps" it to the 
R A M I E K to display that character. Since tne ASCII code for 
the character is required/ this may be achieved in two ways. 
First/ the character may oe enclosed in single auotes within 
the subroutine call/ sucn as 

out ( ' x ' ) ; 

to display the letter x; or/ second/ if the user pre-def i nes 
a character/ sucn as with 

5 d e f i n e C 0 |V 1 M A 0 54 

then the call 



out (COMMA ) ; 

would display a comma at the location of the COP. The x 
value or element position of tne COP is incremented by 7 
elements to prevent destroying that cnaracter with the next 
to be displayed, (see "Alphanumeric :v, ode" ) 



As briefly mentioned in the "Alphanumeric Mode"/ raw 
data is passed to the R A M T E K by the " a u m c " routine. This 
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procedure senos a ore-ceclared number of bytes of data from 
the software buffer (called "buff”) to the R A M T E K hardware 
buffer* The numoer of bytes to oe oassea is normally kept in 
"bytecnt" . The address of the next availaole location in 
"buff" is keot in a o o inter called 11 ctrbuf f \ Tnusr for ex- 
ample/ to send the octal value 060017 to the R A M T E K , the 
following instructions would be used : 

*ptrouff - U b 0 0 1 7 ; 
ot rbu f f t + ; 
bytecnt = bytecnt + 
dumofbuff/bytecnt ) ; 

To operate at this level in the R A T E K environment/ the 
user should familiarize himself with the R A M T E K GX-100 Pro- 
gramming Manual (11 and the R A M T E K software source code 



available in the Lao* 



APPENDIX 8 



SOFTWARE SUPPORT FUNCTION DESCRIPTIONS 



This Apoendi x contains the descriptions of the user in 
terface routines in the format that is followed in the docu 
mentation of the UNIX ooeratinq system in the N aval Postgra 
duate School Come u ter Laboratory. 



lag 



RESERVED wQPDS 



adoff 


entholh 


LL1 


setup 


aaon 


ec age 1 


LL2 


si x p a k 


alpha 


ecaae2 


L T A 


size 


axis 


entnol d 


LTD 


skip 


BKON 


erase 


1 t t r 


SSC ALL 


8K0FF 


ERS 


LXD 


status 


nxrnd 


f i x p t 


m a x s w 


s t rou t 


blank 


flip 


m o r e i nst 


s t r t x y 


BLK 


frame 


T! S W 


swary 


block 


f c 


n 0 - n 1 7 


symbol 


box 


FPOFF 


c c t b 1 


sy s t b 1 


bracket 


FPQiNj 


out 


t abc o i o r 


bu f 


f t c a 


cause 


t a b d i m 


buff 


ae t f 


D 1 c k 


t a b i n i t 


b u i 1 dsw 


ae t i 


P 1 0 t D t 


tabsw 


o u t b 1 


ae t num 


o 1 c t 1 n 


t b 1 w h o 


b y t ec n t 


aet sw 


cloth 


t da t a 


c 


ae t x y 


point 


terse 


chco 1 


graphcrt 


po i n t r 


t e x t o 


c hnge 


graphelm 


r roc 1 


t f d i 


cl r ho 1 0 


gpaphvec 


d roc 2 


TRANSD 


cl r t b 1 


read 


o roc 3 


triple 


code 


h eaoc t r 


o roc 4 


t X 


code i t 


heat 


o r oc 5 


t x d i m 


coke 


n o 1 a x 


os t. 


t x m a x 


col i n t 


he 1 by 


o t r bu f f 


t x rr i n 


color 


i n b e x 


OUtuD 


t V 


c o 1 o r t 


i.not r s 


act r 


t y d i m 


c o 1 o r t b 1 


i nst r 


qc t r 1 


t y m a x 


col SK 


instl-inst80 


qt 


t y m i n 


comb 


inter 


quest 


upc n t 


CU^MA 


i n t 5 3 


al 


vector 


COMPD 


i n t 6 i) 


r am t e k 


wait 


conve 


i t o a 


RASTERO 


\N DOFF 


C 0 n v 1 


i t o a t 


r eo i m 


/-DON 


c ocy 


I XCFF 


resc 1 r 


w r i ton 


CK 


I X 0 N 


retchar 


x a x i s 


cursor 


L C M 


sa vc 1 r 


xmi n 


data 


1 c mho 1 d 


s a v s t a t 


x m a x 


dataD 


LER 


sc i sso r 


xswi t c h 


db 1 w i a 


LEX 


SCR 


y a x i s 


d i sp 


LEI 


sc r een 


y a x i s f 


dsoyc t b 1 


LE2 


sc ro 1 1 


y m i n 


bump 


LLR 


SDC 0 


y m a x 


e i ns t 


LLX 


se t mode 
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axis 



NAME : 

axis - draw coordinate axis 



SYNOPSIS: 

a x i s ( x t y ) 
float x / y ; 



DESCRIPTION: 

Draws a cartesian coordinate x and 
screen with center at user- defined 
( x / y ) • 

The operation is totally independent 
mode issued or^viously- 

The COP is left at (max x-value^y) . 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates nc portion of 
the user-cef inec screen. 



y axis on the 
screen coordinate 



of any control 



the axis lies on 
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b k rnd 



NAME : 

bkrnd - cnange reverse background flag 



SYNOPSIS : 

b k rnd C g ) 
i n t g ; 



DESCRIP r ION: 



If o is zero, 


the 


reverse 


back 


around flag in 


the con- 


trol nnooe is 


set 


to zero , 


i • e . 


turned off. 




If a is equal 


t o 


one / the 


r e ve 


r s e background 


flag in 


the con t r o 1 m 


ode 


is set to 


one 


, i-e. turned 


on . 


M o r m a 1 return 


i s 


zero- 









DIAGNOSTICS: 










Returned -1 indicates the cassed 
equal to zero or one- 


i n t e q e r 


a 


i s 


not 






* 
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block 



NAME : 

block - draw solid block 



SYNOPSIS: 

block(xl,yl,x2#y<?) 
float x 1 , y 1 , x 2 , v 2 ; 



DESCRIPTION: 

A solid nloc< is drawn w i t n cocosite corners 
fined by user-defined screen coordinates (xl 
( x 2 , y 2 ) . 



as 

,vl) 



de- 

ana 



The COP is left at ( * 2 » y 2 ) . The operation is indepen- 
dent of any node issued oreviously cut is sensitive to 
all flaas aoolicable to Graohic Cartesian none. 



Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the olocx can not be drawn on - 
the user-definec screen. 



SEE ALSO: 

i nde x ( ) , 



nkrnoO , dclwiof) 



bu i I ds w 
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bu i 1 ds w 



NAME : 

b u i I d s w - build logical switches on the tablet 
SYNOPSIS: 

bui ldsw(sw,xh,xl f yn, y| ) 
float xh,xl,yh,yl; 
i n t sw/ 



DESCRIPT IUM: 

Allows tne user to define individual log 
’switches' on the Vector Genera 1 Taolet by passing 
following oarameters : 

1- user's logical switch number (integer) 

2- high x value (real) 

3- low x value (real) 

4- high y value (real) 

5- 1 oa y value freal) 

-- thus defining a selection oox and assianinq it 
desired number. v a x i n u m number of switches is 2 5 . 



DIAGNOSTICS: 

Normal return is the switch number. 

Returned -l indicates attempt to create more than 
s w i tches. 

SEE ALSO: 

sixpakO; tabswt); 



c a 1 
the 



tne 
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chnqe 



NAME : 

chnge - chance color taole entry 



SYNOPSIS: 

chnge ( nurrb / en t ry,cont ) 
int numb/ entry/ cont? 



DESCRIPTION: 

Chances the s c e c i f i e o °nf rv in the indicated color 
table to the casseo oarameter cont . trioleO should 
be used to out cont into the orooer form. 

numb is the table number in which the entry is to be 
cnanqed. entry is the entry number to be changed, 
cont is the integer twelve bit code which is loaded in 
the specified entry. 

Normal return is zero. 



DIAGNOSTICS : 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-1 Indicates numb is less than four or greater than 
se ven t een . 

-2 Indicates entry is negative or greater than fif- 
teen. 



SEE ALSO: 

t r i p 1 e C ) 
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cl r t b 1 
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cl r t b 1 



NAME: 

clrtbl - load color table 



SYNOPSIS : 

cl rtDl ( n , name ) 
i n t n , ‘name; 



DESCRIPTION: 

Loads color tatle number n with the codes container) in 
the array oointed to toy name? 



The array is an integer array containing sixteen in- 
tegers which represent the octal code of the color 
table entries between zero and fifteen. The array is 
assumed to be declareg sixfeen words in length. 



n is an inteaer value which ranges from four to seven- 
teen. 



The color 
t ah 1 e s . 

T ao 1 e 
T ab 1 e 
Table 
Tab 1 e 



tables from 
They contain 

0 - Fifteen 

1 - Fifteen 

2 - Fifteen 

3 - Fifteen 



zero to four are system 
the following: 
shades o f grey . 
shages of blue, 
sh ages of green . 
shades of red. 



defined 



If the user desires to modify a system table see 
inter() . 



Normal return is zero. 



DI AGNUS TICS: 

Returned -1 indicates the passed inteaer n is less 
than four or greater than seventeen. 



SEE ALSO: 

triplet) 
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color 
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color 



NAMfc : 

color - select color 



SYNOPSIS : 

co 1 or ( s ) 
i n t s ; 



DESCRIPTION: 

The oassed i nteaer s is the number of the Desired en- 
try in the current color taole. The color located in 
that entry will he used for all subsenuent entities 
displayed until a different color is issued. 

s is net ween zero ana fifteen. 

Normal return is zero. 



DIAGN031 ICS : 

Returned -1 indicates the oassed integer s is negative 
or greater than fifteen. 



SEE ALSO: 

C h nae ( ) 



co 1 o r t 
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col ort 



NAME. : 

colort - select display color taole 



SYNOPSIS : 

co 1 o r t ( t ) 
int t ; 



DESCPIPT ION: 

The massed oarameter t is the number of the color 
table that is sert to t he R A M T E K device for display. 

t is between zero and seventeen. 

\ 

Normal return is zero. 



DIAGNOSTICS: 

Returned "1 indicates the Passed intecjer t is neoative 
or greater than seventeen. 



SEE ALSO: 

c 1 r t b 1 ( ) 
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conve 
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conve 



NAME.: 

conve - convert an x value to an element location 

SYNOPSIS : 

con ve ( x ) 
float x ; 

DESCRIPTION: 

Converts a virtual screen x-oirension value or adaress 
into a real screen element oosition. The floating 



coint oerameter n'ust be a valid 
the current virtual screen soace 


address 

• 


component 


for 


DIAGNOSTICS: 

Returns the number of the real 


sc r^en 


el emen t 


DO s i - 



t i on . 

SEE ALSO: 

conv 1 ( ) ; 



15 a 
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c on v i 



NAME : 

convl - convert a v value to a real screen line number 

SYNOPSIS : 

convl ( y ) 
float y J 

DESCRIP 1 ION: 

Converts a virtual screen y-di mansion value into a 
real screen line number. Tne floating point parameter 
must oe a valid acidress component for the current vir- 
tual screen soace. 



DIAGNGST ICS: 

Returns tne number of the real screen line. 



SEE ALSO: 

convet); 
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cursor 



May 21 
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cursor 



NAME: 

cursor - software cursor ( V . G . tablet driven) 



SYNOPSIS : 

cursor!); 

extern float t x , t y J 



DESCRIPTION: 

This routine ol aces a cursor on the screen of the R A K - 
TEK in color 15 of the current color tael e. The cursor 
is destructive in that- it erases everything that it 
passes over. Control of tne cursor is via the VECTOR 
GENERAL taolet. when the pen is aeoressed the cursor 
ai sanoears ana exits* The x and y values of the 
cen/cursor location are saved in tx ana ty (must be 
global to the user crograrr. ) for tne user* 



DIAGNOSTICS: 

none 



SEE ALSO: 

terse!) , qetxyC) , tabdimf) 



tabinitO , screen!) 
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data 



NAMt : 

data - aisolay raw data 



SYNOPSIS : 

riatatname, 1 ) 
i n t * n a m e / I ! 



DESCRIPTION: 

The raw a a t a oassed in the linear array pointed to by 
name is di sol aved on the P A M \ £ K acccroinq to the 
current control mode. 

1 is tne lenath of the array in bytesl 
Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassea integer 1 is neaative 
or zero . 



SEE ALSO: 

st rout ( ) » 



1 t t r ( ) 
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db 1 vv i d 



NAME: 

dblwia - charge n o u n 1 e width flag 



SYNOPSIS: 

d b 1 w i d ( x ) 
i n t x ; 



DESCRIPTION: 



If x is 


e a u a 1 


t 0 


zero/ 


the aoubl e 


* i d t h 


f 1 aq 


i n 


the 


control 


mooe 


i s 


set to 


zero / i . e . 


turned 


o f f . 






If x is 


equal 


r o 


one/ 


the oouole 


wiath 


flag 


i n 


the 


control 


mode 


i s 


set to 


one / i . e . 


turnea 


on . 






Normal 


return 


i s 


zero. 













DIAGN03T ICS : 

Returned -1 indicates the passed integer x is not 
equal to zero or one. 



SEE ALSO: 

s i ze ( ) 
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d i sp 
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o i sp 



NAME : 

disp - oisolav a selected color taole (long form) 



SYNOPSIS : 

d i s p ( n ) ; 
i n t n ; 



DESCRIPTION: 

The color table denoted by rue integer Parameter 
is displayed or t h » screen, along with the octal 
reauirea to generate each entry. 



SEE ALSO: 

dspy c t b 1 ( ) 



code 
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dspy c t b 1 



NAME : 

dspyctol - aisolay a selected color taMe 



SYNOPSIS : 

dsoyctbl ( j ); 
i n t j ? 

DESCRIPTION: 

The color table denoted by tt>e integer caraireter 
is displayed on tne R a M T E v . Background color is 
0; oisnlay color is entry 15. 



SEE ALSO: 

d i sp ( ) 



entry 
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dump 



NAME : 

dump - send raw data to the R A M T E K 

SYNOPSIS: 

dump(buff, bytes) ! 
char * b u f f > 
int bytes; 



DESCRIPTION: 

'.‘•'rites raw aata to the R A M T E K instruction buffer. This 
routine is Tor low level control of tne RANTER and is 
very restrictive. Tne raw data is interoreted accord- 
ing to tne mode and flaas set within the device. 

DIAGNOST ICS: 
none 



SEE ALSO: 

write!) , PANTEK PROGRAMMERS MANUAL 



1 o 1 



erase 
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erase 



NAME : 

erase - erases the screen 

SYNOPSIS : 

erase ( ) 



DESCRIPTION: 

The P A M T E K screen is erased to the current backaround 
color ( i e / t n e state of the reverse background flag). 
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NAME : 

f i xpr - chanae fixed point f 1 a a in control mode 



SYNOPSIS: 

f i x p t ( x ) 
int x ; 



DESCRIPTION: 

If x is eaual tc zero/ the fixed Point f 1 a q 
control mode is set tc zero/ i.e. turned off. 



in the 



If x is ecua 
trol mode is 



to one / the fivea no int f 
set to one/ i.e. turned on 



aq in the con- 



Meaningful only in Graphic Vector or 
mode. In Graohic Vector mo a e it causes 
vectors to oe drawn from a common ooint 
subseauent (or t^e last previous) strtx 
Plot mooe this flan is used to achieve 
style Plot of 11 p 1 o t h ( ) " • 



Graohic Plot 
a 1 1 suosecuen t 
as issued by a 
y(). In Graphic 
the histogram 



Normal return is zero. 



DIAGNOSTICS: 



Retumeo -1 indicates t n e 


cassed 


inteoer 


X 


i s 


not 


equal to zero or one. 













f t oa 



May 21 1 Q 7 7 



f t oa 



NAME : 

*toa - converts real numbers to ASCII for cutout 



SYNOPSIS : 

f t oa ( i n ) ; 
float in; 



DESCRIPTION: 

Converts a floating n o i n t number to an ASCII code so 
that it may be cutout r c the R A M T E h . The passed float- 
ing ooint number is first converted to the ASCII 
renresentation and t«en output to the RAMTEK screen at 
the user oefinec COP. Allows for only four oioits 
right of the decimal place and eight digits left of 
the decimal ol ace. 



DI A0N0S1 ICS : 
none 



SEE ALSO: 

data!) > i t oa 1 ( ) 



ae 1 1 
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ge t f 



NAME : 

qet f - read floating point number from R A M T E K keyboard 



SYNOPSIS : 

qe t f ( ) 



DESCPIP1 ION: 

Returns a float ina point nurrber from the RAMTEK key- 
board. Ine only numbers r?coani zed are: an optional 

minus sion followed by a strina of digits optionally 
containing one cecima' point* then followed optionally 
by the letter 'e* followed bv a signed integer. 

Normal return is the floating point number. 



SEE ALSO: 

oetnumC), retcharC) 



lo5 
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ge t i 



NAME : 

qeti - return an integer from tne R A M T E K 



SYNOPSIS : 

ge t i ( ) t 

DESCRIPT IUN: 

Returns an integer value from the RApiTEK 
ASCII characters between 0 and 9 / inclusi 
recoani zeaJ al) others are ignored. Upon t y c 
riage return the process begins; hence carri 
denotes end of strina. 



DIAGMUS1 ICS: 
none 



SEE ALSO: 

a t o i O , 



keyboard, 
ve 1 y t are 
i nq a car- 
age return 



r e t c h a r ( ) 



aetnufn 
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NAME : 

getnum - read number from R A M T E K keyboard 



SYNOPSIS: 

qetnun(base) 
i n t base? 



DESCRIPTION: 

Returns a positive or neoat i ve i nteoer number from the 
RAMI E K keyooard. Numerals tyced up to a comma or a c /r 
on the keyboard are considered to oe the number. The 
routine will not return any value until a c/r or a 
comma is t v p e a / nor will i** accept characters other 
than digits from zero to nine when case is eaual to 
ten# or diaits from zero to seven in case of base 
e i ah t • 

base is the base of the inteaer number returned. It 
is restricted to eiaht (octal) or ten (decimal). 

Normal return is the inteaer number. 



DIAGNOST ICS : 

All errors are indicate a by negative returned values. 
Tne error values ana their meanings are as follows: 



-1 


Indicates 

entries. 


a 


c/r was strucK without 


any 


previous 


-2 


Indicates 


the cassed oaranete 1 " base 


was 


not eaual 




to e i qn t 


o r 


ten. 







SEE ALSO: 

retcharOf get f ( ) 
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NAME : 

aetsw - get the number of a selected logical switch 



SYNOPSIS: 

qetswO; 

DESCRIPTION: 

Determines if the user has selected a valic logical 
switch on the Vector General taolet. If so/ it returns 
the number of that switch. 



DIAGNOSTICS: 

Returned - 1 indicates invalid selection. 
SEE ALSO: 

buildswO; s i x o a < ( ) ; t a b s w ( ) ; 
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NAME : 

ge t x y 



get 



x , y coordinates of a ooint on 



the tablet 



SYNOPSIS : 

getxy(o) 
i n t o ; 

extern float t x , t y ; 



DESCRIPTION: 

Reads (into global variables tx and ty) the x,y coor- 
dinate values from tne tablet at the ooint defined by 
the tio of the stylus. If the parameter 'o' is a 1 , 
the stylus must be depressed on the tablet surface to 
select a ooint/" if 'c' is a 0, the coordinates nearest 
the tio of the oen are read. These coordinates are 
automatically converted to virtual tablet coordinates 
if the tablet nas been redinensioneo (bv a crior call 
to taodin) . 



lo° 
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index 



NAME: 

index - select indexing 



SYNOPSIS: 

i n d e x ( i ^x,y) 
float x f y ; 
i n t i ; 



DESC9IPT IuN: 

If i equals zer c, indexing is deselected ana the in- 
dexing flag in the control mode is turned off. The 
index reaisters are then 1 oaoea with zero. 



If i equals one, indexing is selected ana the indexing 
flag in the control mooe is turned on. The i noex re- 
gisters are then loaded with the disolacements oassed 
in x and y. x is loaded in the x-index (element) re- 
gister and y is loaded in the /-index (line) register. 



x must oe no greater than the user-defined screen 
width. y must be no greater than the user-defined 
screen neiaht . 



Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated oy negative returned values. 
Trie error values ana their meanings are as follows: 

-1 Indicates tne oassed integer i is not equal to 
zero or one . 

-2 Indicates c^e of the oassed displacements x ana y 
is greater than the screen width or heiaht. 

SEE ALSO: 

screen!) 
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inter 



NAME: 

inter 



interactive color table modification routine 



SYNOPSIS: 

i n t e r ( ) 



DESCRIPTION: 

Sets ud and runs a tutorial program that enables the 
user to Ioqk at/ select ana modify color tables during 
program execution. There are two basic mooes in which 
the routine operates* Each of these modes has a 
series of commands whi cn the user can execute. 



1. Pacing Mode. Upon execution the paging mode is 
immediately entered and a set of instructions is 
displayed. Tne following commands are then accept - 
able: 

p - Indicates a carticular table number is to be 
disolayed. The number must then be entered 
between zero and seventeen. 



n - Increments table number displayed by one. 
b - Decrements t a o 1 e number displayed by ore. 
i - Displays instructions. 





q - Quits f 


r om the i 


nteractive 


routine. 






e - Enters 


the edit 


m o d e . 






2 . 


Edit Mode . 


ii hen the 


edit mode 


is entered/ 


a 



of instructions is displayed listing the commands that 
can be issued ana the edit method tney initiate. The 
commands are: 



t - Enters taole assignment method. Permits en- 
tries from any taole to be copied into the 
table designated oy the user. The taole 
nijfroer which is to receive tne copied en- 
tries must oe entered first. 



o - Enters octal assignment method. Entries are 
specified in a designated taole by entering 
the ordered triole that defines the color 
desired. The table number (4-17) in whicn 
the entries are to oe defined must be en- 



tered first 



c - Enters combi ni nq assignment method- This 
methoc allows the user to logically OR two 
seoarate color lockup table entries into a 
selected user table entrv. Whole tables may 
also be combined into a selected user table. 
The user table number (4-17) must be entered 
f i r s t . 

f - Enters inverting tables method. This method 
inverts the user taole designated by the 
user- Entry zero oecomes fifteen, entry one 
becomes fourteen, etc. The act of entering 
the user table number executes the inver- 
sion. 

m - Enters coovinq tables method. After entry of 
the user table number that is to receive a 
cociec table the number of the table to be 
cooieo is entered. The act of enter i n a the 
seconc taole number causes the copy to ta^e 
o 1 ac e . 

Upon entry, the editing methods display a list of in- 
structions on how the metnon is to be used and the 
results obtainec. Each of the metnoos have commands 
that may be issued. The 1 e a a 1 commands for eacn edit 
methoc are summarized below. 

- Taole Assignment Method. 

n - Indicates tne table number ana entry 
to ce coc-ied follows. 
c/r-Increments through the entries 
in t h e receiving user table, 
p - Displavs the color lookup table b e - 
modifieo. To return from the di s- 
o 1 a y , tyce a g . 

a - Quits o a c * to edit moae instructions. 



- Octal Assignment *•« et hod. 

n - Indicates the octal triple to be en- 
tered as the entry follows. 
c/r-Increments throuah the entries 
in the receiving user table, 
p - Disolavs the color lookuo table be- 
ing modified. To return from tne 
display/ tvoe a q . 

a - Quits back to edit moce instructions. 



Conjoining Assianment Method. 

n - Indicates the two oraered d a i r s 

designating the table number ana 
entry number to be 0 P d are to fol- 
low. 

c/r-Incremen ts through the entries in 
the receiving user table, 
o - Di sol ays the color 1 ookuo table 

being modified. To return from 
the ai splay/ type a q. 
w - Indicates two whole tables are to 
be combined C 0 P d ) ana their n u m - 
cers are to follow. 

a - Quits back to eait mode instructions 

Invert i nc Tables Method. 

c - Displays tne color lookup table that 
is being or was inverted, 
a - Quits o a c < to edit moae instructions 

C o p y i n a 



o 

a 



Tables Method. 

Di sol avs the receiving taole. 

Quits back to eait moae instructions 
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NAME : 

itoal - converts integers to ASCII for outDut 



SYNOPSIS: 

i t oa 1 ( i n ) ; 
int inJ 



DESCRIPTION: 

Itoal ta^es an integer value anc converts it to an 
ASCII coaed character string. Having converted the 
value it is then gisDlayea at the user cefined COP. 



DIAGNGS I ICS : 
none 



SEE ALSU: 

ftoa() , data!) 
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NAMt : 

Ittr - oi sol ay sinale character 



SYNOPSIS: 

1ttr(cn,size) 
i n t c h * size? 



DESCRIPTION: 

vnll ni sol ay the character cassea with the size indi- 
cated at the current operating point. 

After display* the current operating point is on t n e 
sane line and seven actual screen elements to the 
right of its last position. 

ch contains the ASCII code for the character to be 
displayed* or the actual character enclosed in single 
Quotes. 

If size is eaual to one* the character is displayed in 
standard size. 

If size is equal to two* the character is displayed in 
ooud 1 e wiotn size. 

The operation is independent of any mode issued previ- 
ously* out is sensitive to the flags applicable to Al- 
phanumeric mode. 

Normal return is zero. 



DIAGNOST ICS : 

Returned -1 indicates the cassea integer size was not 
equal to one or two. 



SEE ALSU : 

st rout ( ) * a a t a ( ) * sized* inoexO, b < r n a O * writcnC) 
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N A M t : 

out - outputs S C I I cnaracters to the P A ?•' T E K 

SYNOPSIS: 

out(ch); 



DESCRIPTION: 

Echos the passec ASCII codec character to the PAMTEK 
screen. Tne COP is then incremented to the right to 
prevent overwri t ina. 

Typical call: 
out ( 48 ) ; 



DIAGNOSTICS: 

none 



SEE ALSO: 

dump!) » lttr() , retcrar( ) 
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NAME : 

oick - output an integer net ween zero ana seventeen 



SYNOPSIS : 

0 i c k ( i ) ; 

1 n t i ? 



DESCRIPTION: 

Outputs an integer to tne R A • T E K screen (between 0 ana 
17) aeoending entirely uoon tne oassea cara^eter. In- 
flexion out useful in di Sclavs involving cclor table 

maniDulation. 



DIAGNOSTICS: 

none 



SEE ALSO: 

a a t a ( ) 
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NAME : 

cloth - plot aata as a histooram 



SYNOPSIS : 

ploth(x,y,n,base) 
float *x , *v r baser 
i n t n ; 



DESCRIPTION: 

The values ytil are treated as functions of x(i]. is 
the function is plotted? the area between the curve 
ana the x-axis? as designated by baser is filled in 
with the color last selected. 

That oortion of the histogram that lies on the screen 
will oe clotted. 

The operation is totally independent of any control 
mode issued previously. 

x and y are Pointers to linear arrays, 
n is the number of points to be plotted. 

Normal return is zero. 



DIAGNOSTICS: 

All errors are i n aicsted by neqative returned values. 
The error values and their meanings are as follows: 

Returned -1 indicates the passed parameter base is not 
on the user-defined screen. 



SEE AlSO: plotlnOr 



plotot ( ) 
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P 1 o t 1 n 



NA^t : 

olotln - clot data with connected lines 



SYNOPSIS : 

plot ln(x/y<n) 
float *xi * v » 
i n t n ; 

DESCRIPT IoM: 

Tne values vli) are treated as functions of *[ij. As 
the function is clotted/ tne successive points are 



connected bv 
ea . 


straiant lines 


of the color 


last 


select- 


Tnat portion 
screen will 


of tne clotted 
be plotted. 


curve ^ h i c h 


lies 


on t h e 



The ooeration is totally inaeoendent of any control 
node issued oreviously. 



x and v are oointers to linear arrays, 
n is the nunoer of points to be plotted. 



SEE ALSU: 

ol ottl ( ) « olotDt ( ) 



P 1 otot 
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NAMt : 

p I otot - plot data w •' t H ooints 

SYNOPSIS: 

plotct (x»v,n) 
float *x» * y » 

i n t n ; 



DESCRIPTION: 

Tne values of v(il a r : j treated as functions of xti). 
The function is plotter 'with dots for each ( x [ i j * y t i 1 ) 
coordinate. Tne dots ire in tne color last selected. 

If a ooint does not li ; on tee user- defined screen/ it 
is not plotted. 

The ooeration is total!/' independent of anv control 
node issued previously. 

x and y are pointers to linear arrays, 
n is the numoer of point; to be clotted. 



SEE AlSU: 

olotht)/ p 1 o t 1 n ( ) 
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oo i n t 



N A M t : 

ooi nt - define point 
sr NUPSIS : 

Doi nt ( x , y ) 
float x , y ; 

DESC R 1 p T ION: 

Defines a ooi nt on the virtu/ 1 screen. The point must 
lie within the us^r-def i ned screen. 

It in Graohic Vector mode, ( < , y ) defines the endpoint 
of a vector and causes it to be drawn. The current 
operating ooi nt is then ( x , y ) . 

If in the Graohic -artesian m j a e , ( * , v ) defines the 

diagonally oooosit/ corner (from the COP) of a pro- 
posed rectangle. Tna rectangle thus defined is shaded 
in the currently selected color. The cuurent onerating 
point is tnen ( x , y ) . 

If in the Graphic El e-rent mode, (x,y) defines a single 
point on the user-df f i ned screen ana causes a dot to 
be drawn there. The ;urrent operating point is then 
( x , y ) . 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates t r e oassea point aces not lie on 
the user-definpc screen. 

SEE ALSO : 

s t r t x y ( ) 
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N A M t : 

ooi nt r - define a ooint relative 



SYNOPSIS: 

o o i n t r f x f y ) 
f 1 oa t x f y ; 



DESCRIP I ION: 

Defines a coi nt on the user*oef i ned screen relative to 
r n e last current ooerat i ng point. 

If in Graohic Vector node * vector from the last 



current ooeratina 


ooint 


to a 


ooint defined oy 


the 


last 


current operating 


ooint 


o 1 u s 


c he d i so 1 acemen t s 


X 


ana y 


is drawn. 












If in tne Graphic 


C a r t es 


i an 


hoc e / a rectangle 


1 s 


de - 



fined oy the current operating ooint and the point 
computed bv adding x and y to c' e COP. This rectangle 
is disolavea in the crrent col c r . 



If in Graphic Element node a dot is drawn at 
defined bv tne last current o i' rating ooint 
displacements x and v. 



a ooint 
plus tne 



The COP is left 



at the cal cul atec 



location. 



SEE ALSU: 

s t r t x y ( ) 
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name : 

nantek - initiates RAMTEK system 

SYNOPSIS: 

ram t e k ( ) 



OESCRIP 1 ION : 

Initiates the RAMTEK system ana sets the default con- 
ditions as follows: 



1 


- Initialize the user-1/ f inea 
100. 0 in x and y. 


screen 


t o 


0.0 to 


2 


- Loads a shades of are/ color 
RAMTEK . 


table 


(0) 


in the 


3 

a 


• Selects color fifteen in taole zero 
- Selects Alphanumeric control noae* 


for 


display. 


5 

6 


- Opens the RAMTEK for r jf ding 

- Erases Che screen. 


and wrj 


t i ng 


• 



Normal return is zero. 



01 AGNOS r ICS : 

Returned -1 indicates RAMIE* device coula not be 
opened. 
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NAMt : 

redim - re dimension the values re«d from the tablet 
SYNOPSIS : 

r ed i m ( ) ; 

extern float tx,tyl 



DESCRIPTION: 

Pe dimensions or converts 'he curre it x , y coorci nates 
read by "get xy" to virtual tablet ci orcinates. This is 
apolicaole after the routine "tabain" has been used to 
redimension the virtual t a j 1 e t to a user-defined size. 
The convertel cooriinate va'ues are olaced in global 
v a r i a o 1 e s tx and tv. do oarameters are passed either 
*/ay by this function. 

SEE ALSO: 

aetxvO; 
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N A M t : 

resc 1 r - restore tne user's color taoles to tne system 



SYNOPSIS: 

resc 1 r C ) ; 

char * save o l » 

extern colortbl U U / 



DESCRIP 1 ION: 

The user's version of tne color tanles are brougnt 
into the svstem from a user file c tiled " s a v c o 1 " «nich 
must have been created by a orior Cell to savclrC ). 

Normal return is the number of bytes reea from 
"savcol" into "colortbl (1 11" (should be 443). 



D I A 0 N 0 3 1ICS: 

Re t u rnea 
the file 
Re t u rnea 
"savcol " 



-1 indicates an unsuccessful attemot to 
"savcol " . 

-2 indicates an error i i reading 
to colortbl nu. 



open 
f rom 



SEE ALSO: 

s a vc I r ( ) 



restat 



May 21 1977 



rest at 



!M AME : 

restat - restore t He R A M T E K (am V G Taolet 
ous status 



SYNOPSIS: 

restat ( ) ; 



DESCR I P I 1 0 M : 

The control status that was in effect at t 
the last call tc savstat ( ) is restored to 

This includes •node/ control flags* color 
trie dimensions of tne virtual s;reen ana 
diet. 



SEE ALSU: 

s a v s t a t ( ) 



) to o r e v i - 



he tine of 
the R A i v ' T E K . 
t ac 1 e / ana 
virtual ta* 
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NAME : 

rstchar - read a character from RA^fEK keyboard 



SYNOPSIS: 

r e t c h a r ( ) 



DESCRIPTION : 

An ASCII cooe reoresent i ng the typed character i 
turned i r the lower half of an integer. 

SEE also: 

aetnumt), get f ( ) / qeti() 



re- 
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NAME : 

save 1 r - save the current color tables 



SYNOPSIS: 

s a v c 1 r ( ) ; 

char * s a v c o 1 # 

extern colortbl 11 [1 I 



DESCRIPl ION: 

The current user-avai 1 aol e color taoles (4 - 17) are 

saved into a ne^l y-created file called "saved ” in the 
user’s directory. This tile may suoseouently oe re* 
opened and read back into the system by a call to 
resclr( ). Tnis allows the user to preserve oesireo 
color serenes between sessions. 

Nornal return is the number of ovtes reaa into 
"savcol " - - (should be 4 U 6 ) . 



OIAGNOST ICS: 

Returned -1 indicates an unsuccessful attempt to 
create the file "savcol " . 

p etumed -2 indicates an error in writina to "savcol " 
from colortbl U . 



SEE ALSO: 

r esc 1 r ( ) 






( 
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sa v s t a t 



NAMt : 

s a v $ t a t - save tne status of the R A M T E K displav 



SYNOPSIS: 

s a v s t a t ( ) ? 



DESCRIPT ION: 

The current control status of the RAM TER and 
GENERAL Tablet is saved for subsequent use. T n i 
includes tne 100®/ control flaas/ current color 
and the dimensions of tne virtual screen and v 
tablet. 



see also : 

rest at ( ) 



VECTOR 
s da t a 
table/ 
i rtual 
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NAME: 

screen - define user screen 



3 YINIUP3 I 3 : 

screentxUvl r x 2 , y 2) 
float xlf y 1 f x2 * y 27 



DESCRIPTION: 

.Defines a standard cartesian coordinate system of any 
scale for tne user. The ooint ( x 1 , y 1 ) becomes t n e 
coordinate of tne lower left corner of tne screen. 
Tne point ( x 2 9 y 2 ) oecomes the coordinate of the upper 
right corner of the screen. 

xl must be strictly less than x2 • 

yl must be strictly less than v2. 

All subsequent user coordinates are interpreted ac- 
cording to this user-aef ined screen. 

Normal return is zero. 



DIAUNOS I ICS: 

Returned -1 indicates xl is not less than x 2 or yl is 
not less than y 2 • An error message is also Printed on 
the terminal screen. 



sc ro 1 I 



May 21 1977 



sc ro I 1 



NAME : 

scroll - scroll screen 



synopsis: 

S c r o 1 1 ( a / C n t ) 
char a t 
f 1 oa t cnt ; 



DESCRIPTION: 



Tne current 


a i sp 1 


ayed oicture 


on 


t 


he 


screen 


i s 


scrolled up or 


down 


. In format l on 


sc r o 1 


1 ed 


off tne 


too 


of the screen 


will 


oe scrolled 


i n 


t 


n e 


Do t tom 


and 



vice-versa. 

If a is the cnaracter 1 a 1 , the direction of rne scroll 
will o e down. 

If a is tne character , u , j the direction of the scroll 
will o e u c . 

cnt is the number of user-defined v-units Clines) that 
the picture is to oe scrolled. cnt can be no larger 
than tne virtual screen height. 

Normal return is zero. 



DI AGNUS ( ICS: 

All errors are indicated o v negative returned values. 
The error values ana their meanings are as follows: 

-l Indicates the oassed parameter cnt was less than 
zero or greater than the screen height. 

-2 Indicates the passed Parameter a was not a 'a' or 
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NAME : 

set mode - select control mode 



SYNOPSIS : 

set mode ( a , b ) 
i n t a , 0 / 



DESCRIPTION: 

Selects the control mode according to tne passed 
oarameters a and n. a reoresents the control moae as 
f o 1 lows: 



0 - Alphanumeric 

1 - Transverse Data 

2 - Paster Data 

3 - Comolex Data 

d - Graohic Vector 
S - G r a d n i c Plot 
o - Graohic Cartesian 
7 - Grannie Element 



All flags are turned off if b is eaual to zero. If o 
is equal to one, anv flags set in the previous mode 
are also set with tne mode selected by a. All enti- 
ties disolayed suoseauent to this call are disolayed 
according to the selected mode. Routines that disre- 
gard the selected m Q de are axis!)/ bl ock () / inter!), 
1ttr(), oloth!), olotlnO, olotot!), textoO/ and vec- 
tor!). 



Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-I Indicates the cassed oarameter a was less than 
zero or greater than seven. 

-2 Indicates the passed oarameter b was not ecual to 
zero or one . 

SEE ALSO: 

r a m c e k ( ) , b k r n a ! ) , d b 1 w i d ( ) , fixot!), index!), 
wr i ton! ) 
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N A M E : 

sixoak - select f rosi six standard switches on tablet 



SYNOPSIS : 

s i x o a '< ( ) ; 



DESCRIPTION: 

Establishes a oacxage of six selection boxes or 
switches on tne Vector General t an let (according to 
Template 1) and returns the nun oer of the switch 
selected o v toe user with the stylus. 



DI AGMOS r ICS : 

Normal return is the number of the switch selected 
( 1 -6) . 

Returned -l indicates invalid selection. 



SEE ALSO: 

buildswO; aetsw(); tabsw(); 
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size 



NAME : 

size - select letter size - 



SYNOPSIS : 

s i ze ( r ) 
i n t r ; 



DESCRIPT ION: 

If r is equal to one the standard character size is 
usea. 

If r is eoual to two the double width character size 
is used . 

Sets the douole wiJth flag in the control m o a e . 
Therefore size takes the sane action as a b 1 v* i o ( 1 ) . 

Normal return is zero. 



DIAGNOSTICS: 

Returned "1 indicates the oassea oara meter r is not 
equal to one or two. 

SEE ALSO: 

do 1 w i d ( ) / 



St rout ( ) » 1 t t r ( ) 
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st rout 



NAME : 

st rout - outout character string 



SYNOPSIS: 

s t rou t ( so ) 
char * so ? 



DESCRIPTION: 

Outputs a character string no greater than 100 charac- 
ters long oeginnino at the current ooerat i ng point and 
continuing on the sane line. After comoletion, an au- 
torat ic line feel occurs which defines a new current 
operating ooint on the next line at the sane starting 
ooint as the orevious line. 

so ooints to the character strino to oe output. 

N ormal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the string contained no re than 
100 characters. In this case no characters will be 
d i sol a y e d . 



SEE also: 

d a t a ( ) f s i 2 e ( ) / 1 1 1 r ( ) , textoO 
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s t r t x y 



NAME : 

strtxy - establish current operating point 

SYNOPSIS : 

strtxyCxr y) 
float x , y ; 

DESCRIPTION: 

Establishes f n e current ooerating po ; nt on the screen 
for suDseauent instructions. If t 1 e current ^ode is 
Graphic Vector with the fixed point flag set* it es- 
tablishes tne case from which the victors are drawn. 

x is a user-defined screen 1 o c a t i > n in x. 
v is a user-defined screen location in y. 

( x / y ) must lie within the user-defined screen. 

Normal return is zero. 



DIAGNOSTICS: 

Returned - 1 indicates ( x * y ) does not lie on the user- 
defined screen. 



SEE alSO: 

f i x o t ( ) # screen!)/ ooint () 



196 



symbol 



May 21 1977 



symbol 



N A M t : 

symbol - disolay a special svfbol 



SYNOPSIS: 

symbol ( s y ) ,’ 
i n t s y 1 6 ) / 



DESCRIPTION: 

Draws the symool that has oeen defined by tne user. 
Thus tne user may ae f i n e special symbols to auqment 
tne standard ACSII craracter set. R e a u i r e s the Dointer 
sy to the user-defined array. This routine automati- 
cally outputs 12 ovtes in th» Iransv irse Data mode. 



typical data declaration: 

int aloha (] {0000000,0009092, 

0052210,0052092, 

ooooooo,ooooooo>; 



tyDical call: 

tdatalaloha, 12,50.0,50.0) ; 



SEE ALSO: 

t da t a ( ) 
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tabcolor 



NAME : 

tabcolor - tablet color ranioulac ion function 



SYNOPSIS: 

t aocc 1 o r ( ) ? 



DESCRIPTION: 

Allows for 
fables via 
prompts for r 
elate for the 
must oe initi 



the interactive modification 
Me '-'ECTOR GENERAL TA3LET. 
equi rea incuts 
tablet is r eat 
alized prior to 



o f 
The 



color 

system 



f r )t 


the 


tablet. 


A t e m - 


i r^o 


for 


input. The tablet 


1 1 


i na 


tabcolor 


! see t a- 



bint). 

Typical call: 

t a o i n i t ( ) ; 
taocolort); 



IS 


/& 


11 
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h a 
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Template Description 



DIAGNOS TICS: 

interactive to t n e R A M T E K aw access terminal. 

SEE ALSO: 

inter!) , savcolorO > rest 1 r( ) , cringe!) » color!) 

eolert!) - t a b i n i t ( ) 
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t abd i m 



NAME : 

taDdi fri 



redimension the /irtuel 



t a: 1 e t 



SYNOPSIS : 

taOdiT(xmax/xminrvmax,vmir ) 
douD I e xmaxi xmin, vmax f vmif ; 



DESCRIPTION: 



A c c e o t s as parameters a max 
tne * and y dimensions (in 
tablet to tnese dimensions, 
tne virtual tael et in any 
to tne standard Cartesian 
reoresented at t K e lower 
values located at tne uooer 



imum anc mini 


mum v a 


1 u e for 


that 


c raer) 


and 'sets' the 


Alio/ 


! the 


user 


to view 


size 


( at tern 


tnat 


Conforms 


grid 


(minimum x , y 


values 


left 


c o r n e 


r ; max 


i nnum x / y 


r i gn t 


corner 


) . 
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t ab i n i t 



NAME : 

t a b i n i t - ooen the t a o 1 e t for the user 



SYNOPSIS : 

t ab i n i t ( ) ; 



DESCRIPT ION: 

Opens the Vector General t a b < ' t and establishes 
access via file-ocinter f d i . Sets the rraxirrun 
of loqical switches available to 2 5 . Prints an 
message if unable to ooen t i * device. 



user 
n umb e r 
errof' 



200 



t a b s w 



f^ay 21 1 ° 7 7 



tabsw 



NAME : 

tabsw - interactively clef if e switches on the tablet 



SYNOPSIS: 

tabsw (sw) 
i n t s w ; 



DESCRIPTION: 

Allows the user to define a set of logical switches on 
the r a olet cv utilizing the sty 1 * s to select the low 
set of coordinates, the i the high set of coordinates 
( i e , the lower left corner of the desired selection 
box, tnen trie ucoer rigrt come* of the box). The 
number of switches to be defined is indicated by the 
oaraneter ' sw ' . The switches are numoered seauent i a I I y 
as they are defined. 



Prints the x , y values 
switch number assignor 



as sele;ted, alona with the 
after each selection orccess. 



SEE ALSO 



b u i 1 d s w ( ) ; a e t s w ( ) ; s i x d a k ( ) ; 
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t e x t o 



NAME : 

texto - ai sol av a block of ter t 



SYNOPSIS : 

texto(txtfCtao^col »sz»wo)» 
i n t ctab^col fSZfWo? 

Char * t x t l 1 { 



DESCRIPT ION: 

The nu 1 t i ol e-entry array of variable lenath character 
strings a d dressed by *txt is oisolayeo on the RAMJEK 
according to the other parameters : 

ctab = > desired cola* table number 

col “ > color entrv r y i o^ that table 

sz = > desired chara er size (1 or 2 ) 

wo = > 1 if additive ’rite is desi redf 0 if not 

Normal return is zero 



DIAGNOSTICS: 

Returned -1 indicates om 
too long (over 100 
NOTE: any strings over 91 characters 
" the screen r n the same 



of the character 



i n 

line* 



strings is 
length will 



* r a o arouno 
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NAME : 

to I who - request for c iTent col ' r table number 



SYNOPSIS : 

t D 1 w h o ( ) 



DESCRIPTION: 

Returns an 
the color 
cl i sp 1 a v . 



inteoer v-Vue which is the tabTe number of 
table t - a t is c.rrent ly being used for 
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t da t a 



NAMt : 

tdata - outouts transverse g/ t a for tne user 



SYNOPSIS: 

tdat3(trd»bvfx,v) 
i n t t r d [ ] ) 
i n t by? 
float x , y ; 



DESCRIP r ION : 

The variable t ro is the n i^e of an array containing 
the transverse data definition for the image, by is 
tne number of Dvfes to be passed ! x , y are the 
starting points for the desired display. The 
transverse data is oroces! ed Dvte by byte with each 
byte oeinq displayed oi ret t I v beneath tne last one. 



typical data declaration: 

int alohafl {00000)0,0000042, 
00*322 iO, 00520^2, 
0000000 , 00000001 ; 



typical cal): 

taatafalcha, 12,50.' ,50.0),' 



The function will not o » r m i t moving off of the screen 
as it oumos to tne ri i h t one oyte ana repositions tne 
user selected y value end continues. 



DIAGNOS TICS: 
none 



SEE ALSU: 

setmodeC) , symbol () 
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terse 



NAME : 

terse - selectively erases the screen 
SYNOPSIS: 

terse(era#erb,erc*e. rd) ; 
float era/erbiercierd; 



DESCRIPTION: 

Allows tie 
screen ov 
co rne r s of 
be paintea 



user to selectively erase a oortion of 
cessing the coorainates of two oocos 
a box. Tie ar°a within tne 0 e f i n e n o o x w 
to the back around color. 



DIAGNOSTICS: 

none 

SEE ALSO: 

strtxyO f ooint () / set^odeU / bloc<() 



the 
i t e 
i 1 1 
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t r i o 1 e 



NAME : 

triple - cone color from three-number triple 



SYNOPSIS : 

triole(brcur) 
i n t b r q , r ; 



DESCRIPTION: 



The 


three input 


parameters 


represent i ng 


the intensi- 


1 1 


es 


of b 1 ue ( b ) 


, green(q) 


and reci(r) 


are 


cooed into 


an 


inteaer wnich 


i 


s suitable 


for insert 


i on 


into a color 


t ao 1 


e entry. 
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ue 
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intensi t y 


o f 


a r ee 


n desired 


• 














r 


i s 


between 


0 


and 


15 and 


represent s 


t n e 


intensity 


0 f 



red oe s i r eci . 

Normal return is an integer representing the coae. 



DIAGNOSTICS: 

Returnee -l indicates input parameters o / o or r are 
neaative or greater than 15. 



SEE ALSO: 

chnpeO, cl r t b 1 CD 
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vector 



NAME : 

vector - craw single vector 



SYNOPSIS : 

vectcrCx 1 , y 1 t x 2 , y 2 ) 
float x ! , yl, x 2 , y 2 ; 



DESCRIPTION: 

A vector is drawn cn the screen from user-aef i ned 
screen coordinate (xl,yl) to (*2>y2). The current 
operating ooint is left at ( x 2 , y 2 ) . 

The ooerat i on is inaeoendent of any mode issued crevi - 
ously but is sensitive to the f 1 a a s a o p 1 i cable to the 
Graphic Vector control mode. Unaesi red results may be 
obtained if the f i xot f 1 a a is set previous to calling 
vec t o r ( ) . 

Normal return is zero. 



DIAGNOSTICS: 

Peturnec *1 indicates no cortion of the indicated line 
lies on the user defined screen. 



SEE ALSO: 

b*rnd()f a b 1 w i d ( ) f f i x o t ( ) / index!) 
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w r i ton 



NAME : 

wri ton - additive write 



SYNOPSIS : 

wri ton ( w) 
i n t w ; 



DESCRIPTION: 

If w is a one , the additive write flag in the control 
mode is turned on causina subsequent entities in A 1 - 
ohanumericf Raster Data and Transverse Data modes to 
write on too of orevious entities without destroying 
them. 

If w is a, zero, t n e additive write flag in the control 
rnoae is turned off. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassea integer w is neaative 
or greater tnan on^. 
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